@nockdev/awf 6.2.0

package/.agent/skills/core/error-handling/data/ui-error-patterns.yaml

@@ -0,0 +1,135 @@
+metadata:
+  skill: error-handling
+  domain: ui_error_patterns
+  version: 6.2.0
+  updated: '2026-02-05'
+  migrated_from: ui-error-patterns.csv
+  patterns_count: 20
+  columns:
+  - id
+  - pattern
+  - description
+  - example
+  - framework
+  - level
+patterns:
+- id: UI-001
+  pattern: React Error Boundary
+  description: Catch errors in component tree
+  example: class ErrorBoundary extends React.Component { componentDidCatch() }
+  framework: React
+  level: INTERMEDIATE
+- id: UI-002
+  pattern: React getDerivedStateFromError
+  description: Update state on error
+  example: 'static getDerivedStateFromError(error) { return { hasError: true }; }'
+  framework: React
+  level: INTERMEDIATE
+- id: UI-003
+  pattern: React componentDidCatch
+  description: Log error info
+  example: componentDidCatch(error, errorInfo) { logError(error, errorInfo); }
+  framework: React
+  level: INTERMEDIATE
+- id: UI-004
+  pattern: React Fallback UI
+  description: Show fallback on error
+  example: <ErrorBoundary fallback={<ErrorPage />}><App /></ErrorBoundary>
+  framework: React
+  level: BASIC
+- id: UI-005
+  pattern: React useErrorBoundary Hook
+  description: Hook-based error boundary
+  example: const { error, resetBoundary } = useErrorBoundary();
+  framework: React
+  level: INTERMEDIATE
+- id: UI-006
+  pattern: Vue errorCaptured
+  description: Capture child component errors
+  example: errorCaptured(err, vm, info) { return false; }
+  framework: Vue
+  level: INTERMEDIATE
+- id: UI-007
+  pattern: Vue app.config.errorHandler
+  description: Global error handler
+  example: app.config.errorHandler = (err, vm, info) => { }
+  framework: Vue
+  level: INTERMEDIATE
+- id: UI-008
+  pattern: Vue onErrorCaptured
+  description: Composition API error handling
+  example: onErrorCaptured((err, instance, info) => { })
+  framework: Vue
+  level: INTERMEDIATE
+- id: UI-009
+  pattern: Angular ErrorHandler
+  description: Global error service
+  example: class MyErrorHandler implements ErrorHandler { handleError(error) {} }
+  framework: Angular
+  level: INTERMEDIATE
+- id: UI-010
+  pattern: Global window.onerror
+  description: Catch unhandled errors
+  example: window.onerror = (msg, url, line) => { }
+  framework: Vanilla JS
+  level: BASIC
+- id: UI-011
+  pattern: Global unhandledrejection
+  description: Catch promise rejections
+  example: window.addEventListener('unhandledrejection', (e) => { })
+  framework: Vanilla JS
+  level: BASIC
+- id: UI-012
+  pattern: Toast Notification
+  description: Show error as toast
+  example: toast.error('Operation failed');
+  framework: Any
+  level: BASIC
+- id: UI-013
+  pattern: Inline Error Message
+  description: Show error near input
+  example: <input /><span class='error'>Invalid email</span>
+  framework: Any
+  level: BASIC
+- id: UI-014
+  pattern: Error Banner
+  description: Full-width error display
+  example: <div class='error-banner'>System Error</div>
+  framework: Any
+  level: BASIC
+- id: UI-015
+  pattern: Error Modal
+  description: Modal dialog for errors
+  example: <Modal open={hasError}><ErrorContent /></Modal>
+  framework: Any
+  level: INTERMEDIATE
+- id: UI-016
+  pattern: Error Page
+  description: Dedicated error page
+  example: /error?code=500 route
+  framework: Any
+  level: BASIC
+- id: UI-017
+  pattern: Retry Button
+  description: Allow user to retry
+  example: <button onClick={retry}>Try Again</button>
+  framework: Any
+  level: BASIC
+- id: UI-018
+  pattern: Loading State Error
+  description: Error during loading
+  example: if (error) return <ErrorMessage />; if (loading) return <Loading />;
+  framework: Any
+  level: BASIC
+- id: UI-019
+  pattern: Form Validation Error
+  description: Show validation errors
+  example: errors.email && <span>{errors.email}</span>
+  framework: Any
+  level: BASIC
+- id: UI-020
+  pattern: Error List
+  description: List all errors
+  example: <ul>{errors.map(e => <li>{e}</li>)}</ul>
+  framework: Any
+  level: INTERMEDIATE

package/.agent/skills/core/logging/META.yaml

@@ -0,0 +1,73 @@
+name: logging
+version: "6.2.0"
+display: Logging Best Practices
+category: core
+tier: 1
+priority: 1
+
+desc: "Comprehensive logging patterns covering structured logging, log levels, 12+ programming languages, log aggregation (ELK/Loki/Splunk), and OpenTelemetry integration."
+
+triggers:
+  file_patterns: []
+  keywords:
+    - logging
+    - structured logging
+    - log levels
+    - JSON logging
+    - slog
+    - zap
+    - zerolog
+    - Winston
+    - Pino
+    - structlog
+    - loguru
+    - SLF4J
+    - Log4j2
+    - Serilog
+    - NLog
+    - Monolog
+    - ELK
+    - Loki
+    - Splunk
+    - OpenTelemetry
+  intents:
+    - setup logging
+    - structured logs
+    - log aggregation
+    - opentelemetry logging
+
+caps:
+  - Structured logging patterns (JSON, key-value)
+  - Log levels semantics (TRACE/DEBUG/INFO/WARN/ERROR/FATAL)
+  - Language-specific libraries and best practices
+  - Log aggregation and shipping patterns
+  - OpenTelemetry logging integration
+  - Correlation IDs and distributed tracing
+  - Anti-patterns to avoid
+
+hsa:
+  enabled: true
+  adapter: logging_adapter.py
+  functions:
+    - search_logging_patterns
+    - get_language_patterns
+    - get_aggregation_patterns
+    - get_otel_logging
+
+data_files:
+  - data/core-patterns.yaml
+  - data/language-go.yaml
+  - data/language-python.yaml
+  - data/language-typescript.yaml
+  - data/language-rust.yaml
+  - data/language-java.yaml
+  - data/language-csharp.yaml
+  - data/language-swift.yaml
+  - data/language-kotlin.yaml
+  - data/language-others.yaml
+  - data/aggregation-patterns.yaml
+  - data/otel-logging.yaml
+  - data/anti-patterns.yaml
+
+related_skills:
+  - observability

package/.agent/skills/core/logging/SKILL.md

@@ -0,0 +1,184 @@
+# 📝 Logging Best Practices Skill
+
+> Comprehensive logging patterns for 12+ languages with HSA integration
+
+---
+
+## Overview
+
+| Metric            | Value |
+| ----------------- | ----- |
+| **Patterns**      | 300+  |
+| **Languages**     | 12    |
+| **Data Files**    | 13    |
+| **HSA Functions** | 4     |
+
+---
+
+## Language Coverage
+
+### Backend / Systems
+
+| Language | Libraries              | Key Patterns                        |
+| -------- | ---------------------- | ----------------------------------- |
+| **Go**   | slog, zap, zerolog     | Structured logging, JSON handlers   |
+| **Rust** | tracing, log           | Spans, events, subscribers          |
+| **Java** | SLF4J, Log4j2, Logback | Facades, MDC, async appenders       |
+| **C#**   | ILogger, Serilog, NLog | Sinks, enrichers, message templates |
+| **C++**  | spdlog, glog           | High-performance, async logging     |
+
+### Scripting / Dynamic
+
+| Language       | Libraries                  | Key Patterns               |
+| -------------- | -------------------------- | -------------------------- |
+| **Python**     | logging, structlog, loguru | Processors, JSON, rotation |
+| **TypeScript** | Winston, Pino              | Transports, child loggers  |
+| **PHP**        | Monolog, PSR-3             | Handlers, formatters       |
+| **Ruby**       | Logger, Semantic Logger    | Tagged logging             |
+
+### Mobile
+
+| Language   | Libraries              | Key Patterns             |
+| ---------- | ---------------------- | ------------------------ |
+| **Swift**  | OSLog, Logger          | Unified logging, privacy |
+| **Kotlin** | kotlin-logging, Timber | Android logging, tags    |
+
+### Functional
+
+| Language   | Libraries         | Key Patterns       |
+| ---------- | ----------------- | ------------------ |
+| **Elixir** | Logger, Telemetry | Metadata, backends |
+
+---
+
+## Core Patterns
+
+### Log Levels
+
+```
+TRACE → DEBUG → INFO → WARN → ERROR → FATAL
+```
+
+| Level | When to Use                               |
+| ----- | ----------------------------------------- |
+| TRACE | Very detailed debugging (loop iterations) |
+| DEBUG | Debugging information (variable values)   |
+| INFO  | General system events (startup, config)   |
+| WARN  | Potential issues (deprecated, retries)    |
+| ERROR | Errors that need attention                |
+| FATAL | Critical failures, system shutdown        |
+
+### Structured Logging
+
+```json
+{
+  "timestamp": "2024-01-15T10:30:00Z",
+  "level": "INFO",
+  "message": "User login successful",
+  "user_id": "12345",
+  "ip": "192.168.1.1",
+  "duration_ms": 45,
+  "trace_id": "abc123"
+}
+```
+
+### Correlation IDs
+
+```
+trace_id: Links all logs for a request
+span_id: Links logs within operation
+request_id: HTTP request identifier
+```
+
+---
+
+## HSA Integration
+
+### Functions
+
+```python
+# Search across all patterns
+search_logging_patterns("structured logging Go")
+
+# Get language-specific patterns
+get_language_patterns("python")
+
+# Get aggregation patterns
+get_aggregation_patterns("ELK")
+
+# Get OpenTelemetry logging
+get_otel_logging()
+```
+
+### Example Queries
+
+- "How to configure Winston JSON logging?"
+- "Go slog structured logging best practices"
+- "Python structlog processors"
+- "OpenTelemetry log correlation"
+
+---
+
+## Data Files
+
+| File                       | Patterns | Description                |
+| -------------------------- | -------- | -------------------------- |
+| `core-patterns.csv`        | 30       | Fundamentals, log levels   |
+| `language-go.csv`          | 25       | slog, zap, zerolog         |
+| `language-python.csv`      | 25       | logging, structlog, loguru |
+| `language-typescript.csv`  | 25       | Winston, Pino              |
+| `language-rust.csv`        | 25       | tracing, subscribers       |
+| `language-java.csv`        | 25       | SLF4J, Log4j2, MDC         |
+| `language-csharp.csv`      | 25       | Serilog, NLog              |
+| `language-swift.csv`       | 20       | OSLog, unified logging     |
+| `language-kotlin.csv`      | 20       | kotlin-logging, Timber     |
+| `language-others.csv`      | 25       | PHP, Ruby, C++, Elixir     |
+| `aggregation-patterns.csv` | 25       | ELK, Loki, Splunk          |
+| `otel-logging.csv`         | 20       | OpenTelemetry logs         |
+| `anti-patterns.csv`        | 15       | Common mistakes            |
+
+**Total: 305 patterns**
+
+---
+
+## Quick Reference
+
+### Go (slog)
+
+```go
+logger := slog.New(slog.NewJSONHandler(os.Stdout, nil))
+logger.Info("user login",
+    slog.String("user_id", "123"),
+    slog.Int("attempt", 1))
+```
+
+### Python (structlog)
+
+```python
+import structlog
+log = structlog.get_logger()
+log.info("user_login", user_id="123", attempt=1)
+```
+
+### TypeScript (Pino)
+
+```typescript
+import pino from "pino";
+const logger = pino();
+logger.info({ userId: "123", attempt: 1 }, "user login");
+```
+
+### Rust (tracing)
+
+```rust
+use tracing::{info, instrument};
+
+#[instrument]
+fn login(user_id: &str) {
+    info!(user_id, "user login");
+}
+```
+
+---
+
+_DOMYH Awesome Code • Logging Skill v1.0 • 305 Patterns_

package/.agent/skills/core/logging/data/aggregation-patterns.yaml

@@ -0,0 +1,191 @@
+metadata:
+  skill: logging
+  domain: aggregation_patterns
+  version: 6.2.0
+  updated: '2026-02-05'
+  migrated_from: aggregation-patterns.csv
+  patterns_count: 25
+  columns:
+  - pattern_id
+  - category
+  - platform
+  - name
+  - description
+  - example
+  - when_to_use
+patterns:
+- id: AGG-001
+  category: elk
+  platform: Elasticsearch
+  name: Index Template
+  description: Define index structure
+  example: 'PUT _index_template/logs { "index_patterns": ["logs-*"] }'
+  when_to_use: ELK setup
+- id: AGG-002
+  category: elk
+  platform: Elasticsearch
+  name: ILM Policy
+  description: Index lifecycle management
+  example: 'PUT _ilm/policy/logs-policy { "phases": { "hot": {}, "warm": {} } }'
+  when_to_use: Log retention
+- id: AGG-003
+  category: elk
+  platform: Logstash
+  name: Input Plugin
+  description: Log ingestion
+  example: input { beats { port => 5044 } }
+  when_to_use: Receiving logs
+- id: AGG-004
+  category: elk
+  platform: Logstash
+  name: Filter Pipeline
+  description: Transform logs
+  example: filter { json { source => "message" } }
+  when_to_use: Log parsing
+- id: AGG-005
+  category: elk
+  platform: Logstash
+  name: Output Plugin
+  description: Send to Elasticsearch
+  example: output { elasticsearch { hosts => ["localhost:9200"] } }
+  when_to_use: Indexing logs
+- id: AGG-006
+  category: elk
+  platform: Kibana
+  name: Discover
+  description: Search logs
+  example: 'Use KQL: level:ERROR AND service:api'
+  when_to_use: Log exploration
+- id: AGG-007
+  category: elk
+  platform: Kibana
+  name: Dashboard
+  description: Visualize logs
+  example: Create panels for error rates, response times
+  when_to_use: Monitoring
+- id: AGG-008
+  category: filebeat
+  platform: Filebeat
+  name: filebeat.inputs
+  description: Collect log files
+  example: 'filebeat.inputs: [{type: log, paths: [''/var/log/*.log'']}]'
+  when_to_use: Log shipping
+- id: AGG-009
+  category: loki
+  platform: Loki
+  name: Labels
+  description: Index by labels
+  example: '{app="myapp", env="prod"}'
+  when_to_use: Cost-effective logging
+- id: AGG-010
+  category: loki
+  platform: Loki
+  name: LogQL
+  description: Query language
+  example: '''{app="myapp"} |= "error" | json | line_format "{{.message}}"'''
+  when_to_use: Log querying
+- id: AGG-011
+  category: loki
+  platform: Promtail
+  name: scrape_configs
+  description: Log collection
+  example: 'scrape_configs: [{job_name: system, static_configs: [...]}]'
+  when_to_use: Loki ingestion
+- id: AGG-012
+  category: loki
+  platform: Grafana
+  name: Explore
+  description: Loki in Grafana
+  example: Use Explore panel with Loki datasource
+  when_to_use: Log exploration
+- id: AGG-013
+  category: splunk
+  platform: Splunk
+  name: HEC
+  description: HTTP Event Collector
+  example: POST /services/collector/event with token auth
+  when_to_use: Splunk ingestion
+- id: AGG-014
+  category: splunk
+  platform: Splunk
+  name: SPL
+  description: Search Processing Language
+  example: index=main sourcetype=json | stats count by level
+  when_to_use: Log analysis
+- id: AGG-015
+  category: splunk
+  platform: Splunk
+  name: Saved Search
+  description: Scheduled search
+  example: Create alerts for error patterns
+  when_to_use: Alerting
+- id: AGG-016
+  category: cloud
+  platform: CloudWatch
+  name: Log Groups
+  description: AWS log organization
+  example: aws logs create-log-group --log-group-name /app/myservice
+  when_to_use: AWS logging
+- id: AGG-017
+  category: cloud
+  platform: CloudWatch
+  name: Insights
+  description: CloudWatch query
+  example: fields @timestamp, @message | filter level = 'ERROR'
+  when_to_use: AWS log analysis
+- id: AGG-018
+  category: cloud
+  platform: Cloud Logging
+  name: Structured Logs
+  description: GCP structured
+  example: jsonPayload.level = "ERROR"
+  when_to_use: GCP logging
+- id: AGG-019
+  category: cloud
+  platform: Cloud Logging
+  name: Log Router
+  description: Route to BigQuery
+  example: Create sink to BigQuery for analytics
+  when_to_use: GCP log routing
+- id: AGG-020
+  category: cloud
+  platform: Azure Monitor
+  name: Diagnostic Settings
+  description: Azure log config
+  example: Create diagnostic setting to Log Analytics
+  when_to_use: Azure logging
+- id: AGG-021
+  category: fluentd
+  platform: Fluentd
+  name: source
+  description: Log input
+  example: <source> @type tail path /var/log/*.log </source>
+  when_to_use: Multi-source collection
+- id: AGG-022
+  category: fluentd
+  platform: Fluentd
+  name: match
+  description: Log routing
+  example: <match app.**> @type elasticsearch </match>
+  when_to_use: Log forwarding
+- id: AGG-023
+  category: fluentbit
+  platform: Fluent Bit
+  name: Lightweight Agent
+  description: Resource-efficient
+  example: '[INPUT] Name tail Path /var/log/*.log'
+  when_to_use: Edge/container logging
+- id: AGG-024
+  category: vector
+  platform: Vector
+  name: Pipeline
+  description: High-performance agent
+  example: 'sources: { logs: { type: file } }'
+  when_to_use: Modern log shipping
+- id: AGG-025
+  category: general
+  platform: any
+  name: Centralization Pattern
+  description: Unified log platform
+  example: All services → Aggregator → Storage → Visualization
+  when_to_use: Architecture

package/.agent/skills/core/logging/data/anti-patterns.yaml

@@ -0,0 +1,121 @@
+metadata:
+  skill: logging
+  domain: anti_patterns
+  version: 6.2.0
+  updated: '2026-02-05'
+  migrated_from: anti-patterns.csv
+  patterns_count: 15
+  columns:
+  - pattern_id
+  - category
+  - name
+  - description
+  - bad_example
+  - good_example
+  - impact
+patterns:
+- id: ANTI-001
+  category: basics
+  name: Console in Production
+  description: Using console.log/print in production
+  bad_example: console.log('User:', user)
+  good_example: 'logger.info({ userId: user.id }, ''User action'')'
+  impact: Unstructured unmaintainable logs
+- id: ANTI-002
+  category: basics
+  name: No Log Levels
+  description: Not using log levels
+  bad_example: print('An error occurred')
+  good_example: logger.error('Failed to process', err)
+  impact: Cannot filter by severity
+- id: ANTI-003
+  category: basics
+  name: String Concatenation
+  description: Building log strings eagerly
+  bad_example: logger.debug('User ' + userId + ' action')
+  good_example: logger.debug({ userId }, 'User action')
+  impact: Performance overhead
+- id: ANTI-004
+  category: security
+  name: Logging Passwords
+  description: Including passwords in logs
+  bad_example: logger.info('Login', { password })
+  good_example: logger.info('Login', { userId }) // never password
+  impact: Security vulnerability
+- id: ANTI-005
+  category: security
+  name: Logging PII
+  description: Including personal data
+  bad_example: logger.info({ email, ssn, address })
+  good_example: logger.info({ userId }) // mask or omit PII
+  impact: Privacy violation
+- id: ANTI-006
+  category: security
+  name: Logging Tokens
+  description: Including auth tokens
+  bad_example: logger.debug({ accessToken })
+  good_example: 'logger.debug({ tokenHash: hash(token) })'
+  impact: Token exposure
+- id: ANTI-007
+  category: context
+  name: No Context
+  description: Logs without identifying information
+  bad_example: logger.error('Request failed')
+  good_example: logger.error({ requestId, userId }, 'Request failed')
+  impact: Cannot trace issues
+- id: ANTI-008
+  category: context
+  name: No Timestamp
+  description: Missing or inconsistent timestamps
+  bad_example: 'Custom format: 01/15/24'
+  good_example: 'ISO 8601: 2024-01-15T10:30:00Z'
+  impact: Correlation issues
+- id: ANTI-009
+  category: context
+  name: No Correlation ID
+  description: No request tracing
+  bad_example: logger.info('Processing')
+  good_example: logger.info({ traceId, spanId }, 'Processing')
+  impact: Cannot trace distributed requests
+- id: ANTI-010
+  category: performance
+  name: Sync File Logging
+  description: Blocking file I/O
+  bad_example: fs.writeFileSync(logFile, msg)
+  good_example: Use async logger or buffer
+  impact: Application slowdown
+- id: ANTI-011
+  category: performance
+  name: Over-Logging
+  description: Logging every small event
+  bad_example: for (item in items) logger.debug(item)
+  good_example: 'logger.debug({ count: items.length }, ''Processing batch'')'
+  impact: Performance and storage issues
+- id: ANTI-012
+  category: structure
+  name: Inconsistent Format
+  description: Mixed log formats
+  bad_example: Some JSON some text
+  good_example: Consistent JSON across all services
+  impact: Parsing difficulties
+- id: ANTI-013
+  category: structure
+  name: Deep Nesting
+  description: Deeply nested log objects
+  bad_example: '{ user: { account: { profile: { ... } } } }'
+  good_example: Flatten to 2-3 levels max
+  impact: Query performance
+- id: ANTI-014
+  category: operations
+  name: No Rotation
+  description: Unbounded log files
+  bad_example: Single growing log file
+  good_example: Rotate by size or time
+  impact: Disk exhaustion
+- id: ANTI-015
+  category: operations
+  name: No Retention
+  description: Keeping logs forever
+  bad_example: No deletion policy
+  good_example: 'Hot: 7d, Warm: 30d, Cold: 1yr'
+  impact: Storage cost explosion