@nockdev/awf 6.2.0

package/.agent/skills/core/logging/data/language-rust.yaml

@@ -0,0 +1,191 @@
+metadata:
+  skill: logging
+  domain: language_rust
+  version: 6.2.0
+  updated: '2026-02-05'
+  migrated_from: language-rust.csv
+  patterns_count: 25
+  columns:
+  - pattern_id
+  - category
+  - library
+  - name
+  - description
+  - example
+  - when_to_use
+patterns:
+- id: RS-001
+  category: tracing
+  library: tracing
+  name: info! macro
+  description: Log at info level
+  example: info!(user_id = %id, "User logged in")
+  when_to_use: General events
+- id: RS-002
+  category: tracing
+  library: tracing
+  name: debug! macro
+  description: Log at debug level
+  example: debug!(value = ?obj, "Processing")
+  when_to_use: Debugging
+- id: RS-003
+  category: tracing
+  library: tracing
+  name: error! macro
+  description: Log errors with context
+  example: error!(error = %e, "Operation failed")
+  when_to_use: Error handling
+- id: RS-004
+  category: tracing
+  library: tracing
+  name: warn! macro
+  description: Log warnings
+  example: warn!(retries = count, "Retrying operation")
+  when_to_use: Potential issues
+- id: RS-005
+  category: tracing
+  library: tracing
+  name: trace! macro
+  description: Detailed tracing
+  example: trace!("Entering function")
+  when_to_use: Fine-grained debugging
+- id: RS-006
+  category: tracing
+  library: tracing
+  name: span!
+  description: Create named span
+  example: let span = span!(Level::INFO, "my_span", key = value)
+  when_to_use: Operation tracking
+- id: RS-007
+  category: tracing
+  library: tracing
+  name: '#[instrument]'
+  description: Auto-instrument function
+  example: '#[instrument(skip(password))]'
+  when_to_use: Function tracing
+- id: RS-008
+  category: tracing
+  library: tracing
+  name: instrument attrs
+  description: Skip or rename fields
+  example: '#[instrument(fields(user_id = %id), skip_all)]'
+  when_to_use: Selective instrumentation
+- id: RS-009
+  category: tracing
+  library: tracing
+  name: Span::enter
+  description: Enter a span
+  example: let _guard = span.enter()
+  when_to_use: Manual span lifecycle
+- id: RS-010
+  category: tracing
+  library: tracing
+  name: in_scope
+  description: Execute code in span
+  example: span.in_scope(|| { /* code */ })
+  when_to_use: Closure-based spans
+- id: RS-011
+  category: tracing-subscriber
+  library: tracing-subscriber
+  name: fmt::init
+  description: Simple subscriber init
+  example: tracing_subscriber::fmt::init()
+  when_to_use: Quick setup
+- id: RS-012
+  category: tracing-subscriber
+  library: tracing-subscriber
+  name: fmt().init
+  description: Custom formatting
+  example: tracing_subscriber::fmt().with_max_level(Level::DEBUG).init()
+  when_to_use: Custom configuration
+- id: RS-013
+  category: tracing-subscriber
+  library: tracing-subscriber
+  name: json
+  description: JSON output
+  example: tracing_subscriber::fmt().json().init()
+  when_to_use: Production logging
+- id: RS-014
+  category: tracing-subscriber
+  library: tracing-subscriber
+  name: with_env_filter
+  description: Environment-based filter
+  example: EnvFilter::from_default_env()
+  when_to_use: RUST_LOG control
+- id: RS-015
+  category: tracing-subscriber
+  library: tracing-subscriber
+  name: Layer
+  description: Custom subscriber layer
+  example: 'impl<S> Layer<S> for MyLayer where S: Subscriber'
+  when_to_use: Custom processing
+- id: RS-016
+  category: tracing-subscriber
+  library: tracing-subscriber
+  name: Registry
+  description: Compose multiple layers
+  example: Registry::default().with(layer1).with(layer2)
+  when_to_use: Multi-layer setup
+- id: RS-017
+  category: tracing-appender
+  library: tracing-appender
+  name: rolling
+  description: Rolling file appender
+  example: tracing_appender::rolling::daily(dir, prefix)
+  when_to_use: Log rotation
+- id: RS-018
+  category: tracing-appender
+  library: tracing-appender
+  name: non_blocking
+  description: Non-blocking writer
+  example: let (writer, guard) = tracing_appender::non_blocking(appender)
+  when_to_use: Async file writes
+- id: RS-019
+  category: log
+  library: log
+  name: log facade
+  description: Standard log macros
+  example: log::info!("Message")
+  when_to_use: Compatibility layer
+- id: RS-020
+  category: log
+  library: log
+  name: tracing-log
+  description: Bridge log to tracing
+  example: LogTracer::init()
+  when_to_use: Legacy compatibility
+- id: RS-021
+  category: async
+  library: tracing
+  name: Future instrumentation
+  description: .instrument() for futures
+  example: async_fn().instrument(span).await
+  when_to_use: Async tracing
+- id: RS-022
+  category: async
+  library: tracing
+  name: Instrument trait
+  description: Instrument futures
+  example: use tracing::Instrument; fut.instrument(span)
+  when_to_use: Explicit instrumentation
+- id: RS-023
+  category: otel
+  library: tracing-opentelemetry
+  name: OpenTelemetry layer
+  description: Export to OTel
+  example: OpenTelemetryLayer::new(tracer)
+  when_to_use: Distributed tracing
+- id: RS-024
+  category: general
+  library: any
+  name: Error Display
+  description: '%e for Display formatting'
+  example: error!(%error, "Failed")
+  when_to_use: Error messages
+- id: RS-025
+  category: general
+  library: any
+  name: Debug Display
+  description: ?obj for Debug formatting
+  example: debug!(?complex_struct, "State")
+  when_to_use: Debug output

package/.agent/skills/core/logging/data/language-swift.yaml

@@ -0,0 +1,156 @@
+metadata:
+  skill: logging
+  domain: language_swift
+  version: 6.2.0
+  updated: '2026-02-05'
+  migrated_from: language-swift.csv
+  patterns_count: 20
+  columns:
+  - pattern_id
+  - category
+  - library
+  - name
+  - description
+  - example
+  - when_to_use
+patterns:
+- id: SW-001
+  category: oslog
+  library: OSLog
+  name: Logger
+  description: Create OSLog Logger
+  example: 'let logger = Logger(subsystem: Bundle.main.bundleIdentifier!, category: "network")'
+  when_to_use: iOS/macOS apps
+- id: SW-002
+  category: oslog
+  library: OSLog
+  name: log.info
+  description: Log at info level
+  example: logger.info("User \(userId) logged in")
+  when_to_use: General events
+- id: SW-003
+  category: oslog
+  library: OSLog
+  name: log.debug
+  description: Log at debug level
+  example: logger.debug("Processing item \(item)")
+  when_to_use: Debugging
+- id: SW-004
+  category: oslog
+  library: OSLog
+  name: log.error
+  description: Log errors
+  example: 'logger.error("Failed to fetch data: \(error.localizedDescription)")'
+  when_to_use: Error handling
+- id: SW-005
+  category: oslog
+  library: OSLog
+  name: log.warning
+  description: Log warnings
+  example: 'logger.warning("Network response slow: \(duration)ms")'
+  when_to_use: Potential issues
+- id: SW-006
+  category: oslog
+  library: OSLog
+  name: log.critical
+  description: Log critical errors
+  example: logger.critical("Database corruption detected")
+  when_to_use: Severe issues
+- id: SW-007
+  category: oslog
+  library: OSLog
+  name: log.trace
+  description: Trace-level logging
+  example: logger.trace("Entering function")
+  when_to_use: Fine-grained debug
+- id: SW-008
+  category: oslog
+  library: OSLog
+  name: Privacy
+  description: Mark data as private
+  example: 'logger.info("Email: \(email, privacy: .private)")'
+  when_to_use: Privacy protection
+- id: SW-009
+  category: oslog
+  library: OSLog
+  name: Public Privacy
+  description: Mark data as public
+  example: 'logger.info("Count: \(count, privacy: .public)")'
+  when_to_use: Visible in Console
+- id: SW-010
+  category: oslog
+  library: OSLog
+  name: Sensitive Privacy
+  description: Extra sensitive data
+  example: 'logger.info("Token: \(token, privacy: .sensitive)")'
+  when_to_use: Highly sensitive
+- id: SW-011
+  category: oslog
+  library: OSLog
+  name: Subsystem
+  description: Organize by subsystem
+  example: 'subsystem: "com.example.myapp"'
+  when_to_use: Log organization
+- id: SW-012
+  category: oslog
+  library: OSLog
+  name: Category
+  description: Organize by category
+  example: 'category: "networking"'
+  when_to_use: Log filtering
+- id: SW-013
+  category: oslog
+  library: OSLog
+  name: OSLogStore
+  description: Read logs programmatically
+  example: 'let store = try OSLogStore(scope: .currentProcessIdentifier)'
+  when_to_use: Log export
+- id: SW-014
+  category: oslog
+  library: OSLog
+  name: Console.app
+  description: View logs in Console
+  example: Filter by subsystem in Console.app
+  when_to_use: Development debugging
+- id: SW-015
+  category: oslog
+  library: OSLog
+  name: Signpost
+  description: Performance intervals
+  example: 'os_signpost(.begin, log: log, name: "Network Request")'
+  when_to_use: Performance profiling
+- id: SW-016
+  category: swift-log
+  library: swift-log
+  name: LogHandler
+  description: Server-side logging protocol
+  example: 'struct MyHandler: LogHandler { ... }'
+  when_to_use: Vapor/server Swift
+- id: SW-017
+  category: swift-log
+  library: swift-log
+  name: Logger
+  description: Server logger
+  example: 'var logger = Logger(label: "com.example.app")'
+  when_to_use: Server applications
+- id: SW-018
+  category: swift-log
+  library: swift-log
+  name: Metadata
+  description: Log metadata
+  example: 'logger[metadataKey: "requestId"] = "\(requestId)"'
+  when_to_use: Request context
+- id: SW-019
+  category: swift-log
+  library: swift-log
+  name: Bootstrap
+  description: Configure logging
+  example: LoggingSystem.bootstrap(StreamLogHandler.standardOutput)
+  when_to_use: Server logging setup
+- id: SW-020
+  category: swift-log
+  library: swift-log
+  name: Log Level
+  description: Set log level
+  example: logger.logLevel = .debug
+  when_to_use: Verbosity control

package/.agent/skills/core/logging/data/language-typescript.yaml

@@ -0,0 +1,191 @@
+metadata:
+  skill: logging
+  domain: language_typescript
+  version: 6.2.0
+  updated: '2026-02-05'
+  migrated_from: language-typescript.csv
+  patterns_count: 25
+  columns:
+  - pattern_id
+  - category
+  - library
+  - name
+  - description
+  - example
+  - when_to_use
+patterns:
+- id: TS-001
+  category: winston
+  library: winston
+  name: createLogger
+  description: Create Winston logger
+  example: 'const logger = winston.createLogger({ level: ''info'' })'
+  when_to_use: Full-featured logging
+- id: TS-002
+  category: winston
+  library: winston
+  name: transports.Console
+  description: Console transport
+  example: new winston.transports.Console()
+  when_to_use: Development output
+- id: TS-003
+  category: winston
+  library: winston
+  name: transports.File
+  description: File transport
+  example: 'new winston.transports.File({ filename: ''app.log'' })'
+  when_to_use: File logging
+- id: TS-004
+  category: winston
+  library: winston
+  name: format.json
+  description: JSON format
+  example: 'format: winston.format.json()'
+  when_to_use: Structured logging
+- id: TS-005
+  category: winston
+  library: winston
+  name: format.combine
+  description: Combine formats
+  example: format.combine(format.timestamp(), format.json())
+  when_to_use: Multiple formatters
+- id: TS-006
+  category: winston
+  library: winston
+  name: format.printf
+  description: Custom format
+  example: 'format.printf(({ level, message }) => `${level}: ${message}`)'
+  when_to_use: Custom output
+- id: TS-007
+  category: winston
+  library: winston
+  name: Child Logger
+  description: Create child with metadata
+  example: 'logger.child({ requestId: ''123'' })'
+  when_to_use: Request-scoped logging
+- id: TS-008
+  category: winston
+  library: winston
+  name: Custom Levels
+  description: Define custom log levels
+  example: 'levels: { error: 0, warn: 1, custom: 2 }'
+  when_to_use: Custom severity
+- id: TS-009
+  category: winston
+  library: winston
+  name: Exception Handling
+  description: Log uncaught exceptions
+  example: 'exceptionHandlers: [new transports.File({ filename: ''exceptions.log'' })]'
+  when_to_use: Error capture
+- id: TS-010
+  category: winston
+  library: winston
+  name: Rejection Handling
+  description: Log promise rejections
+  example: 'rejectionHandlers: [new transports.File({ filename: ''rejections.log'' })]'
+  when_to_use: Async error capture
+- id: TS-011
+  category: pino
+  library: pino
+  name: pino()
+  description: Create Pino logger
+  example: 'const logger = pino({ level: ''info'' })'
+  when_to_use: Fastest JSON logging
+- id: TS-012
+  category: pino
+  library: pino
+  name: Child Logger
+  description: Create child logger
+  example: 'const child = logger.child({ requestId: ''123'' })'
+  when_to_use: Request-scoped logging
+- id: TS-013
+  category: pino
+  library: pino
+  name: Serializers
+  description: Custom object serialization
+  example: 'serializers: { req: pino.stdSerializers.req }'
+  when_to_use: Custom field handling
+- id: TS-014
+  category: pino
+  library: pino
+  name: pino-pretty
+  description: Human-readable output
+  example: 'transport: { target: ''pino-pretty'' }'
+  when_to_use: Development logging
+- id: TS-015
+  category: pino
+  library: pino
+  name: Async Mode
+  description: Async logging for performance
+  example: 'const logger = pino(pino.destination({ sync: false }))'
+  when_to_use: High-throughput
+- id: TS-016
+  category: pino
+  library: pino
+  name: Redact
+  description: Redact sensitive fields
+  example: 'redact: [''password'', ''creditCard'']'
+  when_to_use: Security
+- id: TS-017
+  category: pino
+  library: pino
+  name: Base Properties
+  description: Default fields for all logs
+  example: 'base: { pid: process.pid, hostname: os.hostname() }'
+  when_to_use: Consistent metadata
+- id: TS-018
+  category: pino
+  library: pino
+  name: Level Mapping
+  description: Map log levels
+  example: 'customLevels: { trace: 5, debug: 10 }'
+  when_to_use: Custom levels
+- id: TS-019
+  category: pino
+  library: pino
+  name: pino-http
+  description: HTTP request logging
+  example: app.use(pinoHttp({ logger }))
+  when_to_use: Express/Fastify middleware
+- id: TS-020
+  category: pino
+  library: pino
+  name: Multistream
+  description: Multiple destinations
+  example: 'pino.multistream([{ stream: process.stdout }, { stream: fileStream }])'
+  when_to_use: Multi-target logging
+- id: TS-021
+  category: general
+  library: any
+  name: Error Wrapper
+  description: Structured error logging
+  example: logger.error({ err, requestId, userId }, 'Request failed')
+  when_to_use: Error handling
+- id: TS-022
+  category: general
+  library: any
+  name: Request Middleware
+  description: Express logging middleware
+  example: app.use((req, res, next) => { req.logger = logger.child({ requestId }); next() })
+  when_to_use: Request tracing
+- id: TS-023
+  category: general
+  library: any
+  name: Console Replacement
+  description: Replace console methods
+  example: console.log = (...args) => logger.info({ args }, 'console.log')
+  when_to_use: Legacy code migration
+- id: TS-024
+  category: general
+  library: any
+  name: Browser Logging
+  description: Browser-compatible logging
+  example: if (typeof window !== 'undefined') { /* browser logger */ }
+  when_to_use: Isomorphic apps
+- id: TS-025
+  category: general
+  library: any
+  name: Type-Safe Logging
+  description: TypeScript typed logger
+  example: 'interface Logger { info(msg: string, meta?: Record<string, unknown>): void }'
+  when_to_use: Type safety

package/.agent/skills/core/logging/data/otel-logging.yaml

@@ -0,0 +1,156 @@
+metadata:
+  skill: logging
+  domain: otel_logging
+  version: 6.2.0
+  updated: '2026-02-05'
+  migrated_from: otel-logging.csv
+  patterns_count: 20
+  columns:
+  - pattern_id
+  - category
+  - concept
+  - name
+  - description
+  - example
+  - when_to_use
+patterns:
+- id: OTEL-001
+  category: model
+  concept: OTel
+  name: Log Data Model
+  description: OTel log record structure
+  example: '{ timestamp, severity, body, attributes, resource }'
+  when_to_use: Understanding OTel logs
+- id: OTEL-002
+  category: model
+  concept: OTel
+  name: Severity Number
+  description: Standard severity levels
+  example: '1-24 mapping: 9=INFO, 13=WARN, 17=ERROR'
+  when_to_use: Cross-language consistency
+- id: OTEL-003
+  category: model
+  concept: OTel
+  name: Log Body
+  description: Primary log content
+  example: 'body: "User login successful"'
+  when_to_use: Message content
+- id: OTEL-004
+  category: model
+  concept: OTel
+  name: Log Attributes
+  description: Structured context
+  example: 'attributes: { "user.id": "123", "http.method": "POST" }'
+  when_to_use: Event metadata
+- id: OTEL-005
+  category: model
+  concept: OTel
+  name: Resource
+  description: Log source identification
+  example: 'resource: { "service.name": "api", "service.version": "1.0" }'
+  when_to_use: Service identification
+- id: OTEL-006
+  category: correlation
+  concept: OTel
+  name: Trace ID
+  description: Link logs to traces
+  example: 'traceId: abc123...'
+  when_to_use: Distributed tracing
+- id: OTEL-007
+  category: correlation
+  concept: OTel
+  name: Span ID
+  description: Link logs to spans
+  example: 'spanId: def456...'
+  when_to_use: Operation tracking
+- id: OTEL-008
+  category: correlation
+  concept: OTel
+  name: Trace Flags
+  description: Sampling decision
+  example: 'traceFlags: 01 (sampled)'
+  when_to_use: Sampling control
+- id: OTEL-009
+  category: conventions
+  concept: OTel
+  name: Semantic Conventions
+  description: Standard attribute names
+  example: exception.type, exception.message, exception.stacktrace
+  when_to_use: Interoperability
+- id: OTEL-010
+  category: conventions
+  concept: OTel
+  name: HTTP Attributes
+  description: HTTP log attributes
+  example: http.request.method, http.response.status_code
+  when_to_use: API logging
+- id: OTEL-011
+  category: conventions
+  concept: OTel
+  name: DB Attributes
+  description: Database log attributes
+  example: db.system, db.statement, db.operation
+  when_to_use: Database logging
+- id: OTEL-012
+  category: exporter
+  concept: OTel
+  name: OTLP Exporter
+  description: Export via OTLP
+  example: 'OTLPLogExporter({ url: ''http://collector:4318/v1/logs'' })'
+  when_to_use: Standard export
+- id: OTEL-013
+  category: exporter
+  concept: OTel
+  name: Console Exporter
+  description: Debug output
+  example: SimpleLogRecordProcessor(ConsoleLogRecordExporter())
+  when_to_use: Development
+- id: OTEL-014
+  category: exporter
+  concept: OTel
+  name: Batch Processor
+  description: Efficient batching
+  example: 'BatchLogRecordProcessor(exporter, { maxQueueSize: 2048 })'
+  when_to_use: Production
+- id: OTEL-015
+  category: sdk
+  concept: OTel
+  name: Python SDK
+  description: Python OTel logging
+  example: from opentelemetry._logs import set_logger_provider
+  when_to_use: Python integration
+- id: OTEL-016
+  category: sdk
+  concept: OTel
+  name: Java SDK
+  description: Java OTel logging
+  example: GlobalLoggerProvider.set(sdkLoggerProvider)
+  when_to_use: Java integration
+- id: OTEL-017
+  category: sdk
+  concept: OTel
+  name: Go SDK
+  description: Go OTel logging
+  example: otel.SetLoggerProvider(provider)
+  when_to_use: Go integration
+- id: OTEL-018
+  category: bridge
+  concept: OTel
+  name: Log Bridge
+  description: Connect existing loggers
+  example: LoggingHandler from opentelemetry.sdk._logs
+  when_to_use: Migration
+- id: OTEL-019
+  category: collector
+  concept: OTel
+  name: Collector Receiver
+  description: Receive logs
+  example: 'receivers: { otlp: { protocols: { grpc: {} } } }'
+  when_to_use: Central collection
+- id: OTEL-020
+  category: collector
+  concept: OTel
+  name: Collector Processor
+  description: Transform logs
+  example: 'processors: { batch: {}, filter: {} }'
+  when_to_use: Log processing