@nockdev/awf 6.2.0 → 6.2.1

package/.agent/skills/core/api-design/data/error-responses.yaml

@@ -1,135 +1,135 @@
 metadata:
   skill: api-design
   domain: error_responses
-  version: 6.2.0
-  updated: '2026-02-05'
-  migrated_from: error-responses.csv
+  version: 6.2.1
+  updated: "2026-02-05"
+  migrated_from: error-responses.yaml
   patterns_count: 20
   columns:
-  - id
-  - pattern
-  - description
-  - example
-  - rfc
-  - level
+    - id
+    - pattern
+    - description
+    - example
+    - rfc
+    - level
 patterns:
-- id: ERR-01
-  pattern: RFC 9457 Format
-  description: Standard problem details
-  example: '{type title status detail instance}'
-  rfc: RFC 9457
-  level: BASIC
-- id: ERR-02
-  pattern: Type URI
-  description: URI identifying problem type
-  example: 'type: https://api.example.com/errors/rate-limit'
-  rfc: RFC 9457
-  level: BASIC
-- id: ERR-03
-  pattern: Title
-  description: Short human-readable summary
-  example: 'title: "Rate Limit Exceeded"'
-  rfc: RFC 9457
-  level: BASIC
-- id: ERR-04
-  pattern: Status
-  description: HTTP status code in body
-  example: 'status: 429'
-  rfc: RFC 9457
-  level: BASIC
-- id: ERR-05
-  pattern: Detail
-  description: Specific occurrence explanation
-  example: 'detail: "You have exceeded 100 requests per minute"'
-  rfc: RFC 9457
-  level: BASIC
-- id: ERR-06
-  pattern: Instance
-  description: URI for this occurrence
-  example: 'instance: /logs/abc123'
-  rfc: RFC 9457
-  level: INTERMEDIATE
-- id: ERR-07
-  pattern: Content-Type
-  description: Problem details media type
-  example: 'Content-Type: application/problem+json'
-  rfc: RFC 9457
-  level: BASIC
-- id: ERR-08
-  pattern: Extension Members
-  description: Custom fields in response
-  example: '{...traceId: "abc" retryAfter: 60}'
-  rfc: RFC 9457
-  level: INTERMEDIATE
-- id: ERR-09
-  pattern: Validation Errors
-  description: Array of field errors
-  example: '{errors: [{field: "email" code: "invalid"}]}'
-  rfc: Custom
-  level: BASIC
-- id: ERR-10
-  pattern: Error Codes
-  description: Machine-readable error codes
-  example: '{code: "ERR_INVALID_EMAIL"}'
-  rfc: Custom
-  level: BASIC
-- id: ERR-11
-  pattern: Localized Messages
-  description: i18n error messages
-  example: '{message: "Invalid email" locale: "en"}'
-  rfc: Custom
-  level: INTERMEDIATE
-- id: ERR-12
-  pattern: Stack Trace Hidden
-  description: Never expose stack traces
-  example: Remove stack in production
-  rfc: Security
-  level: BASIC
-- id: ERR-13
-  pattern: Sensitive Data Hidden
-  description: Mask sensitive info in errors
-  example: Hide passwords tokens
-  rfc: Security
-  level: BASIC
-- id: ERR-14
-  pattern: Correlation ID
-  description: Link errors to logs
-  example: '{correlationId: "req-abc123"}'
-  rfc: Observability
-  level: INTERMEDIATE
-- id: ERR-15
-  pattern: Timestamp
-  description: Error occurrence time
-  example: '{timestamp: "2024-01-15T10:30:00Z"}'
-  rfc: Debugging
-  level: BASIC
-- id: ERR-16
-  pattern: Request ID
-  description: Unique request identifier
-  example: 'X-Request-ID: abc123'
-  rfc: Debugging
-  level: INTERMEDIATE
-- id: ERR-17
-  pattern: Documentation Link
-  description: Link to error docs
-  example: '{docs: "https://docs.api.com/errors/E001"}'
-  rfc: DX
-  level: INTERMEDIATE
-- id: ERR-18
-  pattern: Suggested Action
-  description: What client should do
-  example: '{action: "Retry after 60 seconds"}'
-  rfc: DX
-  level: ADVANCED
-- id: ERR-19
-  pattern: Partial Success
-  description: Return partial results with errors
-  example: '{data: [...] errors: [{index: 2}]}'
-  rfc: Bulk ops
-  level: ADVANCED
-- id: ERR-20
-  pattern: Error Hierarchy
-  description: Categorized error types
-  example: '{category: "validation" type: "field_error"}'
-  rfc: Organization
-  level: INTERMEDIATE
+  - id: ERR-01
+    pattern: RFC 9457 Format
+    description: Standard problem details
+    example: "{type title status detail instance}"
+    rfc: RFC 9457
+    level: BASIC
+  - id: ERR-02
+    pattern: Type URI
+    description: URI identifying problem type
+    example: "type: https://api.example.com/errors/rate-limit"
+    rfc: RFC 9457
+    level: BASIC
+  - id: ERR-03
+    pattern: Title
+    description: Short human-readable summary
+    example: 'title: "Rate Limit Exceeded"'
+    rfc: RFC 9457
+    level: BASIC
+  - id: ERR-04
+    pattern: Status
+    description: HTTP status code in body
+    example: "status: 429"
+    rfc: RFC 9457
+    level: BASIC
+  - id: ERR-05
+    pattern: Detail
+    description: Specific occurrence explanation
+    example: 'detail: "You have exceeded 100 requests per minute"'
+    rfc: RFC 9457
+    level: BASIC
+  - id: ERR-06
+    pattern: Instance
+    description: URI for this occurrence
+    example: "instance: /logs/abc123"
+    rfc: RFC 9457
+    level: INTERMEDIATE
+  - id: ERR-07
+    pattern: Content-Type
+    description: Problem details media type
+    example: "Content-Type: application/problem+json"
+    rfc: RFC 9457
+    level: BASIC
+  - id: ERR-08
+    pattern: Extension Members
+    description: Custom fields in response
+    example: '{...traceId: "abc" retryAfter: 60}'
+    rfc: RFC 9457
+    level: INTERMEDIATE
+  - id: ERR-09
+    pattern: Validation Errors
+    description: Array of field errors
+    example: '{errors: [{field: "email" code: "invalid"}]}'
+    rfc: Custom
+    level: BASIC
+  - id: ERR-10
+    pattern: Error Codes
+    description: Machine-readable error codes
+    example: '{code: "ERR_INVALID_EMAIL"}'
+    rfc: Custom
+    level: BASIC
+  - id: ERR-11
+    pattern: Localized Messages
+    description: i18n error messages
+    example: '{message: "Invalid email" locale: "en"}'
+    rfc: Custom
+    level: INTERMEDIATE
+  - id: ERR-12
+    pattern: Stack Trace Hidden
+    description: Never expose stack traces
+    example: Remove stack in production
+    rfc: Security
+    level: BASIC
+  - id: ERR-13
+    pattern: Sensitive Data Hidden
+    description: Mask sensitive info in errors
+    example: Hide passwords tokens
+    rfc: Security
+    level: BASIC
+  - id: ERR-14
+    pattern: Correlation ID
+    description: Link errors to logs
+    example: '{correlationId: "req-abc123"}'
+    rfc: Observability
+    level: INTERMEDIATE
+  - id: ERR-15
+    pattern: Timestamp
+    description: Error occurrence time
+    example: '{timestamp: "2024-01-15T10:30:00Z"}'
+    rfc: Debugging
+    level: BASIC
+  - id: ERR-16
+    pattern: Request ID
+    description: Unique request identifier
+    example: "X-Request-ID: abc123"
+    rfc: Debugging
+    level: INTERMEDIATE
+  - id: ERR-17
+    pattern: Documentation Link
+    description: Link to error docs
+    example: '{docs: "https://docs.api.com/errors/E001"}'
+    rfc: DX
+    level: INTERMEDIATE
+  - id: ERR-18
+    pattern: Suggested Action
+    description: What client should do
+    example: '{action: "Retry after 60 seconds"}'
+    rfc: DX
+    level: ADVANCED
+  - id: ERR-19
+    pattern: Partial Success
+    description: Return partial results with errors
+    example: "{data: [...] errors: [{index: 2}]}"
+    rfc: Bulk ops
+    level: ADVANCED
+  - id: ERR-20
+    pattern: Error Hierarchy
+    description: Categorized error types
+    example: '{category: "validation" type: "field_error"}'
+    rfc: Organization
+    level: INTERMEDIATE

package/.agent/skills/core/api-design/data/graphql-patterns.yaml

@@ -1,165 +1,165 @@
 metadata:
   skill: api-design
   domain: graphql_patterns
-  version: 6.2.0
-  updated: '2026-02-05'
-  migrated_from: graphql-patterns.csv
+  version: 6.2.1
+  updated: "2026-02-05"
+  migrated_from: graphql-patterns.yaml
   patterns_count: 25
   columns:
-  - id
-  - pattern
-  - description
-  - example
-  - level
-  - category
+    - id
+    - pattern
+    - description
+    - example
+    - level
+    - category
 patterns:
-- id: GQL-01
-  pattern: PascalCase Types
-  description: Use PascalCase for type names
-  example: type User type OrderItem
-  level: BASIC
-  category: naming
-- id: GQL-02
-  pattern: camelCase Fields
-  description: Use camelCase for field names
-  example: firstName lastName createdAt
-  level: BASIC
-  category: naming
-- id: GQL-03
-  pattern: Domain-Driven Schema
-  description: Model schema around business domains
-  example: type Product type Inventory
-  level: BASIC
-  category: design
-- id: GQL-04
-  pattern: Strong Typing
-  description: Leverage type system fully
-  example: scalar DateTime enum Status
-  level: BASIC
-  category: design
-- id: GQL-05
-  pattern: Enum Finite Values
-  description: Use enums for fixed value sets
-  example: enum OrderStatus {PENDING SHIPPED}
-  level: BASIC
-  category: design
-- id: GQL-06
-  pattern: Interface Shared Fields
-  description: Use interfaces for common fields
-  example: 'interface Node { id: ID! }'
-  level: INTERMEDIATE
-  category: design
-- id: GQL-07
-  pattern: Union Polymorphism
-  description: Use unions for different types
-  example: union SearchResult = User | Product
-  level: INTERMEDIATE
-  category: design
-- id: GQL-08
-  pattern: Input Types Mutations
-  description: Use input types for mutations
-  example: input CreateUserInput { name email }
-  level: BASIC
-  category: mutations
-- id: GQL-09
-  pattern: Nullable by Default
-  description: Only use Non-Null when guaranteed
-  example: 'field: String vs field: String!'
-  level: INTERMEDIATE
-  category: design
-- id: GQL-10
-  pattern: Cursor Pagination
-  description: Use connection pattern for lists
-  example: first after last before edges
-  level: ADVANCED
-  category: pagination
-- id: GQL-11
-  pattern: Connection Pattern
-  description: Relay-style pagination
-  example: type UserConnection { edges pageInfo }
-  level: ADVANCED
-  category: pagination
-- id: GQL-12
-  pattern: Query Depth Limit
-  description: Prevent deeply nested queries
-  example: 'maxDepth: 7 in validation'
-  level: BASIC
-  category: security
-- id: GQL-13
-  pattern: Query Complexity
-  description: Limit query complexity score
-  example: 'complexityLimit: 1000'
-  level: INTERMEDIATE
-  category: security
-- id: GQL-14
-  pattern: Rate Limiting
-  description: Limit queries per time window
-  example: 100 queries per minute per user
-  level: BASIC
-  category: security
-- id: GQL-15
-  pattern: DataLoader Batching
-  description: Batch N+1 queries with DataLoader
-  example: userLoader.load(userId)
-  level: ADVANCED
-  category: performance
-- id: GQL-16
-  pattern: DataLoader Caching
-  description: Cache within single request
-  example: loader caches per request context
-  level: ADVANCED
-  category: performance
-- id: GQL-17
-  pattern: N+1 Detection
-  description: Detect N+1 query patterns
-  example: Monitoring resolver execution count
-  level: ADVANCED
-  category: performance
-- id: GQL-18
-  pattern: Context Object
-  description: Pass shared data via context
-  example: context.user context.db
-  level: BASIC
-  category: resolvers
-- id: GQL-19
-  pattern: Resolver Focus
-  description: Keep resolvers thin data-fetching
-  example: Extract logic to service layer
-  level: INTERMEDIATE
-  category: resolvers
-- id: GQL-20
-  pattern: Error Extensions
-  description: Add structured error data
-  example: 'extensions: { code field }'
-  level: INTERMEDIATE
-  category: errors
-- id: GQL-21
-  pattern: Partial Success
-  description: Return partial data with errors
-  example: 'data: {} errors: [{path}]'
-  level: INTERMEDIATE
-  category: errors
-- id: GQL-22
-  pattern: Deprecation
-  description: Use @deprecated directive
-  example: '@deprecated(reason: \"Use newField\")'
-  level: BASIC
-  category: evolution
-- id: GQL-23
-  pattern: Schema Documentation
-  description: Document types and fields
-  example: \"\"\"User account\"\"\" type User
-  level: BASIC
-  category: documentation
-- id: GQL-24
-  pattern: Persisted Queries
-  description: Cache query strings server-side
-  example: queryId hash instead of full query
-  level: ADVANCED
-  category: performance
-- id: GQL-25
-  pattern: HTTP Caching
-  description: Support GET with persisted queries
-  example: Cache-Control for read queries
-  level: ADVANCED
-  category: caching
+  - id: GQL-01
+    pattern: PascalCase Types
+    description: Use PascalCase for type names
+    example: type User type OrderItem
+    level: BASIC
+    category: naming
+  - id: GQL-02
+    pattern: camelCase Fields
+    description: Use camelCase for field names
+    example: firstName lastName createdAt
+    level: BASIC
+    category: naming
+  - id: GQL-03
+    pattern: Domain-Driven Schema
+    description: Model schema around business domains
+    example: type Product type Inventory
+    level: BASIC
+    category: design
+  - id: GQL-04
+    pattern: Strong Typing
+    description: Leverage type system fully
+    example: scalar DateTime enum Status
+    level: BASIC
+    category: design
+  - id: GQL-05
+    pattern: Enum Finite Values
+    description: Use enums for fixed value sets
+    example: enum OrderStatus {PENDING SHIPPED}
+    level: BASIC
+    category: design
+  - id: GQL-06
+    pattern: Interface Shared Fields
+    description: Use interfaces for common fields
+    example: "interface Node { id: ID! }"
+    level: INTERMEDIATE
+    category: design
+  - id: GQL-07
+    pattern: Union Polymorphism
+    description: Use unions for different types
+    example: union SearchResult = User | Product
+    level: INTERMEDIATE
+    category: design
+  - id: GQL-08
+    pattern: Input Types Mutations
+    description: Use input types for mutations
+    example: input CreateUserInput { name email }
+    level: BASIC
+    category: mutations
+  - id: GQL-09
+    pattern: Nullable by Default
+    description: Only use Non-Null when guaranteed
+    example: "field: String vs field: String!"
+    level: INTERMEDIATE
+    category: design
+  - id: GQL-10
+    pattern: Cursor Pagination
+    description: Use connection pattern for lists
+    example: first after last before edges
+    level: ADVANCED
+    category: pagination
+  - id: GQL-11
+    pattern: Connection Pattern
+    description: Relay-style pagination
+    example: type UserConnection { edges pageInfo }
+    level: ADVANCED
+    category: pagination
+  - id: GQL-12
+    pattern: Query Depth Limit
+    description: Prevent deeply nested queries
+    example: "maxDepth: 7 in validation"
+    level: BASIC
+    category: security
+  - id: GQL-13
+    pattern: Query Complexity
+    description: Limit query complexity score
+    example: "complexityLimit: 1000"
+    level: INTERMEDIATE
+    category: security
+  - id: GQL-14
+    pattern: Rate Limiting
+    description: Limit queries per time window
+    example: 100 queries per minute per user
+    level: BASIC
+    category: security
+  - id: GQL-15
+    pattern: DataLoader Batching
+    description: Batch N+1 queries with DataLoader
+    example: userLoader.load(userId)
+    level: ADVANCED
+    category: performance
+  - id: GQL-16
+    pattern: DataLoader Caching
+    description: Cache within single request
+    example: loader caches per request context
+    level: ADVANCED
+    category: performance
+  - id: GQL-17
+    pattern: N+1 Detection
+    description: Detect N+1 query patterns
+    example: Monitoring resolver execution count
+    level: ADVANCED
+    category: performance
+  - id: GQL-18
+    pattern: Context Object
+    description: Pass shared data via context
+    example: context.user context.db
+    level: BASIC
+    category: resolvers
+  - id: GQL-19
+    pattern: Resolver Focus
+    description: Keep resolvers thin data-fetching
+    example: Extract logic to service layer
+    level: INTERMEDIATE
+    category: resolvers
+  - id: GQL-20
+    pattern: Error Extensions
+    description: Add structured error data
+    example: "extensions: { code field }"
+    level: INTERMEDIATE
+    category: errors
+  - id: GQL-21
+    pattern: Partial Success
+    description: Return partial data with errors
+    example: "data: {} errors: [{path}]"
+    level: INTERMEDIATE
+    category: errors
+  - id: GQL-22
+    pattern: Deprecation
+    description: Use @deprecated directive
+    example: '@deprecated(reason: \"Use newField\")'
+    level: BASIC
+    category: evolution
+  - id: GQL-23
+    pattern: Schema Documentation
+    description: Document types and fields
+    example: \"\"\"User account\"\"\" type User
+    level: BASIC
+    category: documentation
+  - id: GQL-24
+    pattern: Persisted Queries
+    description: Cache query strings server-side
+    example: queryId hash instead of full query
+    level: ADVANCED
+    category: performance
+  - id: GQL-25
+    pattern: HTTP Caching
+    description: Support GET with persisted queries
+    example: Cache-Control for read queries
+    level: ADVANCED
+    category: caching