@nockdev/awf 6.2.0

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

@@ -0,0 +1,135 @@
+metadata:
+  skill: error-handling
+  domain: api_error_patterns
+  version: 6.2.0
+  updated: "2026-02-05"
+  migrated_from: api-error-patterns.csv
+  patterns_count: 20
+  columns:
+    - id
+    - pattern
+    - description
+    - example
+    - standard
+    - level
+patterns:
+  - id: API-001
+    pattern: RFC 9457 Problem Details
+    description: Standard error response format
+    example: '{"type": "uri", "title": "...", "status": 400}'
+    standard: RFC 9457
+    level: INTERMEDIATE
+  - id: API-002
+    pattern: type Field
+    description: URI identifying error type
+    example: 'type: "https://api.example.com/errors/validation"'
+    standard: RFC 9457
+    level: INTERMEDIATE
+  - id: API-003
+    pattern: title Field
+    description: Human-readable summary
+    example: 'title: "Validation Error"'
+    standard: RFC 9457
+    level: BASIC
+  - id: API-004
+    pattern: status Field
+    description: HTTP status code
+    example: "status: 400"
+    standard: RFC 9457
+    level: BASIC
+  - id: API-005
+    pattern: detail Field
+    description: Human-readable explanation
+    example: 'detail: "The email field is required"'
+    standard: RFC 9457
+    level: BASIC
+  - id: API-006
+    pattern: instance Field
+    description: URI identifying occurrence
+    example: 'instance: "/users/123/requests/abc"'
+    standard: RFC 9457
+    level: ADVANCED
+  - id: API-007
+    pattern: Extension Fields
+    description: Custom fields for domain details
+    example: 'errors: [{"field": "email"'
+    standard: '"message": "..."}]'
+    level: RFC 9457
+  - id: API-008
+    pattern: 400 Bad Request
+    description: Client sent invalid data
+    example: Invalid request body
+    standard: HTTP
+    level: BASIC
+  - id: API-009
+    pattern: 401 Unauthorized
+    description: Authentication required
+    example: Access token required
+    standard: HTTP
+    level: BASIC
+  - id: API-010
+    pattern: 403 Forbidden
+    description: Authenticated but not allowed
+    example: Insufficient permissions
+    standard: HTTP
+    level: BASIC
+  - id: API-011
+    pattern: 404 Not Found
+    description: Resource doesn't exist
+    example: User not found
+    standard: HTTP
+    level: BASIC
+  - id: API-012
+    pattern: 409 Conflict
+    description: Resource state conflict
+    example: Email already registered
+    standard: HTTP
+    level: INTERMEDIATE
+  - id: API-013
+    pattern: 422 Unprocessable Entity
+    description: Validation failed
+    example: Field validation errors
+    standard: HTTP
+    level: INTERMEDIATE
+  - id: API-014
+    pattern: 429 Too Many Requests
+    description: Rate limit exceeded
+    example: Retry after 60 seconds
+    standard: HTTP
+    level: INTERMEDIATE
+  - id: API-015
+    pattern: 500 Internal Server Error
+    description: Server-side error
+    example: An unexpected error occurred
+    standard: HTTP
+    level: BASIC
+  - id: API-016
+    pattern: 503 Service Unavailable
+    description: Temporary overload
+    example: Service temporarily unavailable
+    standard: HTTP
+    level: BASIC
+  - id: API-017
+    pattern: Retry-After Header
+    description: When to retry
+    example: "Retry-After: 120"
+    standard: HTTP
+    level: INTERMEDIATE
+  - id: API-018
+    pattern: X-Request-ID Header
+    description: Request identifier for tracking
+    example: "X-Request-ID: abc-123"
+    standard: Custom
+    level: INTERMEDIATE
+  - id: API-019
+    pattern: Validation Error Array
+    description: List field errors
+    example: '{ "errors": [ { "field": "email", "code": "required" } ] }'
+    standard: Custom
+    level: INTERMEDIATE
+  - id: API-020
+    pattern: Error Envelope
+    description: Wrap response in error object
+    example: '{ "error": { "code": "...'
+    standard: '""message"": ""..."" } }"'
+    level: Custom

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

@@ -0,0 +1,226 @@
+metadata:
+  skill: error-handling
+  domain: core_patterns
+  version: 6.2.0
+  updated: "2026-02-05"
+  migrated_from: core-patterns.csv
+  patterns_count: 30
+  columns:
+    - id
+    - pattern
+    - description
+    - example
+    - category
+    - level
+    - languages
+patterns:
+  - id: EH-CORE-001
+    pattern: Result Type
+    description: Encapsulate success or failure in return type
+    example: "Result<T, E> or Result<Value, Error>"
+    category: Functional
+    level: BASIC
+    languages: Rust, Scala, Kotlin, Swift, TypeScript
+  - id: EH-CORE-002
+    pattern: Either Monad
+    description: Left for error and Right for value
+    example: "Either<Error, Value>"
+    category: Functional
+    level: INTERMEDIATE
+    languages: Scala, Haskell, TypeScript (fp-ts)
+  - id: EH-CORE-003
+    pattern: Option/Maybe
+    description: Represent optional values without null
+    example: "Option<T> or Maybe<T>"
+    category: Functional
+    level: BASIC
+    languages: Rust, Scala, Haskell, Swift
+  - id: EH-CORE-004
+    pattern: Error Wrapping
+    description: Add context to errors while preserving original
+    example: 'fmt.Errorf("context: %w"'
+    category: err)
+    level: Context
+    languages: BASIC
+  - id: EH-CORE-005
+    pattern: Sentinel Errors
+    description: Predefined error values for comparison
+    example: var ErrNotFound = errors.New("not found")
+    category: Definition
+    level: BASIC
+    languages: Go
+  - id: EH-CORE-006
+    pattern: Custom Error Types
+    description: Define domain-specific error types
+    example: class ValidationError extends Error
+    category: Definition
+    level: BASIC
+    languages: All
+  - id: EH-CORE-007
+    pattern: Error Factory
+    description: Create errors with consistent format
+    example: createError(code
+    category: message
+    level: context)
+    languages: Definition
+  - id: EH-CORE-008
+    pattern: Type Assertion
+    description: Check error type at runtime
+    example: errors.As(err
+    category: "&target)"
+    level: Inspection
+    languages: INTERMEDIATE
+  - id: EH-CORE-009
+    pattern: Value Assertion
+    description: Check error value at runtime
+    example: errors.Is(err
+    category: ErrNotFound)
+    level: Inspection
+    languages: BASIC
+  - id: EH-CORE-010
+    pattern: Error Chain
+    description: Link multiple errors in cause chain
+    example: raise NewError from OriginalError
+    category: Context
+    level: INTERMEDIATE
+    languages: Python
+  - id: EH-CORE-011
+    pattern: Monadic Operations
+    description: Chain operations with and_then/map
+    example: result.and_then(|v| process(v))
+    category: Functional
+    level: ADVANCED
+    languages: Rust, Scala
+  - id: EH-CORE-012
+    pattern: Early Return
+    description: Return error immediately on failure
+    example: value = try expression // ? operator
+    category: Control
+    level: BASIC
+    languages: Rust
+  - id: EH-CORE-013
+    pattern: Error Propagation
+    description: Pass errors up call stack
+    example: throw new Error() or return err
+    category: Control
+    level: BASIC
+    languages: All
+  - id: EH-CORE-014
+    pattern: Error Recovery
+    description: Transform errors into default values
+    example: result.unwrap_or(default)
+    category: Recovery
+    level: BASIC
+    languages: Rust, Swift
+  - id: EH-CORE-015
+    pattern: Error Mapping
+    description: Transform error type
+    example: result.map_err(|e| NewError::from(e))
+    category: Transform
+    level: INTERMEDIATE
+    languages: Rust
+  - id: EH-CORE-016
+    pattern: Multiple Error Types
+    description: Handle different error types
+    example: catch (SpecificError | AnotherError e)
+    category: Control
+    level: INTERMEDIATE
+    languages: Java, C#, Python
+  - id: EH-CORE-017
+    pattern: Error Context Struct
+    description: Store rich error information
+    example: struct Error { code, message, cause }
+    category: Definition
+    level: INTERMEDIATE
+    languages: All
+  - id: EH-CORE-018
+    pattern: Null Object Pattern
+    description: Return safe default instead of error
+    example: return EmptyCollection instead of null
+    category: Recovery
+    level: INTERMEDIATE
+    languages: All
+  - id: EH-CORE-019
+    pattern: Railway Oriented
+    description: Two-track error handling
+    example: Success track and Failure track
+    category: Functional
+    level: ADVANCED
+    languages: FP Languages
+  - id: EH-CORE-020
+    pattern: Error Aggregation
+    description: Collect multiple errors
+    example: AggregateException or Vec<Error>
+    category: Collection
+    level: INTERMEDIATE
+    languages: C#, Rust
+  - id: EH-CORE-021
+    pattern: Validation Accumulation
+    description: Collect all validation errors
+    example: "{errors: [field1Error"
+    category: field2Error]}
+    level: Collection
+    languages: INTERMEDIATE
+  - id: EH-CORE-022
+    pattern: Error as Event
+    description: Emit errors as observables
+    example: errorSubject.next(error)
+    category: Reactive
+    level: ADVANCED
+    languages: RxJS, RxJava
+  - id: EH-CORE-023
+    pattern: Lazy Error
+    description: Defer error evaluation
+    example: "|| Err(compute_error())"
+    category: Performance
+    level: ADVANCED
+    languages: Rust
+  - id: EH-CORE-024
+    pattern: Error Hierarchy
+    description: Organize errors in inheritance tree
+    example: BaseError -> NetworkError -> TimeoutError
+    category: Definition
+    level: INTERMEDIATE
+    languages: OOP Languages
+  - id: EH-CORE-025
+    pattern: Typed Errors
+    description: Use type system for error checking
+    example: type-safe error unions
+    category: Definition
+    level: ADVANCED
+    languages: TypeScript, Rust
+  - id: EH-CORE-026
+    pattern: Error Serialization
+    description: Convert errors for transmission
+    example: error.toJSON() or error.serialize()
+    category: Transport
+    level: INTERMEDIATE
+    languages: All
+  - id: EH-CORE-027
+    pattern: Error Deserialization
+    description: Reconstruct errors from data
+    example: Error.fromJSON(data)
+    category: Transport
+    level: INTERMEDIATE
+    languages: All
+  - id: EH-CORE-028
+    pattern: Error Logging
+    description: Record error with context
+    example: logger.error(error
+    category: "{context})"
+    level: Observability
+    languages: BASIC
+  - id: EH-CORE-029
+    pattern: Error Metrics
+    description: Track error counts and types
+    example: "errorCounter.inc({type: 'validation'})"
+    category: Observability
+    level: INTERMEDIATE
+    languages: All
+  - id: EH-CORE-030
+    pattern: Error Alerting
+    description: Notify on critical errors
+    example: alert.send(error) if error.severity == CRITICAL
+    category: Observability
+    level: ADVANCED
+    languages: All

package/.agent/skills/core/error-handling/data/error-codes.yaml

@@ -0,0 +1,165 @@
+metadata:
+  skill: error-handling
+  domain: error_codes
+  version: 6.2.0
+  updated: '2026-02-05'
+  migrated_from: error-codes.csv
+  patterns_count: 25
+  columns:
+  - id
+  - pattern
+  - description
+  - example
+  - level
+  - category
+patterns:
+- id: EC-001
+  pattern: Domain Prefix
+  description: Start error code with domain identifier
+  example: AUTH-001 or PAY-ERR-001
+  level: BASIC
+  category: Structure
+- id: EC-002
+  pattern: Numeric Code
+  description: Use numeric codes for processing
+  example: 1001 for validation error
+  level: BASIC
+  category: Structure
+- id: EC-003
+  pattern: Alphanumeric Code
+  description: Combine letters and numbers
+  example: E1001 or ERR_INVALID_INPUT
+  level: BASIC
+  category: Structure
+- id: EC-004
+  pattern: Severity Level
+  description: Include severity in code
+  example: CRIT-001 for critical
+  level: INTERMEDIATE
+  category: Classification
+- id: EC-005
+  pattern: Category Code
+  description: Group codes by category
+  example: VAL-001 for validation category
+  level: BASIC
+  category: Classification
+- id: EC-006
+  pattern: HTTP Status Mapping
+  description: Map error codes to HTTP status
+  example: 404-001 maps to 404 Not Found
+  level: INTERMEDIATE
+  category: API
+- id: EC-007
+  pattern: Sequential Numbering
+  description: Assign codes sequentially
+  example: 001 -> 002 -> 003
+  level: BASIC
+  category: Structure
+- id: EC-008
+  pattern: Reserved Ranges
+  description: Reserve code ranges
+  example: 1000-1999 for validation
+  level: INTERMEDIATE
+  category: Organization
+- id: EC-009
+  pattern: Unique Identifier
+  description: Ensure global uniqueness
+  example: UUID-based error identifier
+  level: ADVANCED
+  category: Tracking
+- id: EC-010
+  pattern: Version Suffix
+  description: Include version in code
+  example: AUTH-001-v2
+  level: ADVANCED
+  category: Versioning
+- id: EC-011
+  pattern: Error Registry
+  description: Central catalog of codes
+  example: ErrorRegistry.register(AUTH_001)
+  level: INTERMEDIATE
+  category: Organization
+- id: EC-012
+  pattern: Code Lookup
+  description: Function to get error details
+  example: ErrorCatalog.lookup('AUTH-001')
+  level: INTERMEDIATE
+  category: API
+- id: EC-013
+  pattern: Deprecation Mark
+  description: Mark deprecated codes
+  example: AUTH-001 [DEPRECATED]
+  level: INTERMEDIATE
+  category: Lifecycle
+- id: EC-014
+  pattern: Related Codes
+  description: Link related error codes
+  example: AUTH-001 relates to AUTH-002
+  level: ADVANCED
+  category: Organization
+- id: EC-015
+  pattern: Machine Readable
+  description: Codes parseable by machines
+  example: 'JSON: { "code": "AUTH-001" }'
+  level: BASIC
+  category: Format
+- id: EC-016
+  pattern: Human Readable
+  description: Codes understandable by humans
+  example: AUTH_INVALID_PASSWORD
+  level: BASIC
+  category: Format
+- id: EC-017
+  pattern: Localization Key
+  description: Use code as i18n key
+  example: errors.AUTH_001.message
+  level: INTERMEDIATE
+  category: Internationalization
+- id: EC-018
+  pattern: Error Enum
+  description: Define codes as enum
+  example: enum ErrorCode { AUTH_001 = 'AUTH_001' }
+  level: BASIC
+  category: Definition
+- id: EC-019
+  pattern: Constant Definition
+  description: Define codes as constants
+  example: const AUTH_001 = 'AUTH-001';
+  level: BASIC
+  category: Definition
+- id: EC-020
+  pattern: Code Documentation
+  description: Document each error code
+  example: '/** AUTH-001: Invalid password format */'
+  level: INTERMEDIATE
+  category: Documentation
+- id: EC-021
+  pattern: Error Namespace
+  description: Namespace error codes
+  example: Company.Module.ErrorCode
+  level: INTERMEDIATE
+  category: Structure
+- id: EC-022
+  pattern: Recovery Action
+  description: Include recovery hint in code
+  example: AUTH-001-RETRY vs AUTH-001-FATAL
+  level: ADVANCED
+  category: Classification
+- id: EC-023
+  pattern: Transient Marker
+  description: Mark transient errors
+  example: NET-001-T for transient network error
+  level: INTERMEDIATE
+  category: Classification
+- id: EC-024
+  pattern: Permanent Marker
+  description: Mark permanent errors
+  example: VAL-001-P for permanent validation error
+  level: INTERMEDIATE
+  category: Classification
+- id: EC-025
+  pattern: Error Code Type
+  description: Type-safe error codes
+  example: type ErrorCode = 'AUTH-001' | 'AUTH-002'
+  level: INTERMEDIATE
+  category: Type Safety

package/.agent/skills/core/error-handling/data/error-messages.yaml

@@ -0,0 +1,165 @@
+metadata:
+  skill: error-handling
+  domain: error_messages
+  version: 6.2.0
+  updated: "2026-02-05"
+  migrated_from: error-messages.csv
+  patterns_count: 25
+  columns:
+    - id
+    - pattern
+    - description
+    - example
+    - audience
+    - level
+patterns:
+  - id: EM-001
+    pattern: User-Facing Message
+    description: Clear message for end users
+    example: Something went wrong. Please try again.
+    audience: User
+    level: BASIC
+  - id: EM-002
+    pattern: Developer Message
+    description: Technical details for debugging
+    example: NullPointerException at UserService.java:42
+    audience: Developer
+    level: BASIC
+  - id: EM-003
+    pattern: Contextual Information
+    description: Include relevant context
+    example: "Failed to load user: id=123, reason=not found"
+    audience: Developer
+    level: INTERMEDIATE
+  - id: EM-004
+    pattern: Action Suggestion
+    description: Tell user what to do
+    example: Invalid email. Please enter a valid email address.
+    audience: User
+    level: BASIC
+  - id: EM-005
+    pattern: Specific Error
+    description: Precise error description
+    example: Password must be at least 8 characters
+    audience: User
+    level: BASIC
+  - id: EM-006
+    pattern: Error Code Display
+    description: Show error code for support
+    example: "Error AUTH-001: Contact support with this code"
+    audience: User
+    level: INTERMEDIATE
+  - id: EM-007
+    pattern: Timestamp
+    description: Include when error occurred
+    example: Error occurred at 2024-01-15T10:30:00Z
+    audience: Developer
+    level: BASIC
+  - id: EM-008
+    pattern: Request ID
+    description: Include request identifier
+    example: "Request ID: abc-123-def for tracking"
+    audience: Developer
+    level: INTERMEDIATE
+  - id: EM-009
+    pattern: Stack Trace
+    description: Include call stack (dev only)
+    example: Full stack trace in development environment
+    audience: Developer
+    level: BASIC
+  - id: EM-010
+    pattern: Sanitized Output
+    description: Remove sensitive information
+    example: Hide passwords and tokens in logs
+    audience: Security
+    level: INTERMEDIATE
+  - id: EM-011
+    pattern: Localized Message
+    description: Translate to user's language
+    example: Error message in user's locale
+    audience: User
+    level: INTERMEDIATE
+  - id: EM-012
+    pattern: Error Title
+    description: Short title for error
+    example: Authentication Failed as title
+    audience: User
+    level: BASIC
+  - id: EM-013
+    pattern: Error Description
+    description: Longer explanation
+    example: Detailed explanation of what happened
+    audience: User
+    level: INTERMEDIATE
+  - id: EM-014
+    pattern: Structured Log
+    description: JSON format for parsing
+    example: '{"level": "error", "message": "...", "context": {}}'
+    audience: Developer
+    level: INTERMEDIATE
+  - id: EM-015
+    pattern: Correlation ID
+    description: Link related errors
+    example: Same correlation ID across service calls
+    audience: Developer
+    level: ADVANCED
+  - id: EM-016
+    pattern: Error Category
+    description: Classify error type
+    example: "Category: VALIDATION or AUTHENTICATION"
+    audience: Developer
+    level: BASIC
+  - id: EM-017
+    pattern: Environment Info
+    description: Include runtime context
+    example: "Node v18.0.0, OS: Linux, Memory: 512MB"
+    audience: Developer
+    level: INTERMEDIATE
+  - id: EM-018
+    pattern: Previous State
+    description: What was attempted
+    example: "Attempted to create user with email: user@..."
+    audience: Developer
+    level: INTERMEDIATE
+  - id: EM-019
+    pattern: Expected vs Actual
+    description: Show the delta
+    example: Expected array, got string
+    audience: Developer
+    level: INTERMEDIATE
+  - id: EM-020
+    pattern: Documentation Link
+    description: Link to help docs
+    example: "See docs at: https://docs.example.com/errors/AUTH-001"
+    audience: User
+    level: INTERMEDIATE
+  - id: EC-021
+    pattern: Retry Information
+    description: Should user retry
+    example: Please try again in 5 minutes
+    audience: User
+    level: INTERMEDIATE
+  - id: EM-022
+    pattern: Contact Info
+    description: How to get help
+    example: Contact support@example.com for assistance
+    audience: User
+    level: BASIC
+  - id: EM-023
+    pattern: Error Severity
+    description: Indicate severity level
+    example: "[CRITICAL] Database connection failed"
+    audience: Developer
+    level: INTERMEDIATE
+  - id: EM-024
+    pattern: Affected Component
+    description: Which system failed
+    example: Payment Gateway returned error
+    audience: Developer
+    level: INTERMEDIATE
+  - id: EM-025
+    pattern: Input Echo
+    description: Show what user entered
+    example: "Invalid format for: your.email (missing @)"
+    audience: User
+    level: INTERMEDIATE