@nockdev/awf 6.2.0

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

@@ -0,0 +1,191 @@
+metadata:
+  skill: logging
+  domain: language_java
+  version: 6.2.0
+  updated: '2026-02-05'
+  migrated_from: language-java.csv
+  patterns_count: 25
+  columns:
+  - pattern_id
+  - category
+  - library
+  - name
+  - description
+  - example
+  - when_to_use
+patterns:
+- id: JV-001
+  category: slf4j
+  library: SLF4J
+  name: LoggerFactory
+  description: Get SLF4J logger
+  example: Logger logger = LoggerFactory.getLogger(MyClass.class)
+  when_to_use: Every Java class
+- id: JV-002
+  category: slf4j
+  library: SLF4J
+  name: Parameterized Logging
+  description: Use {} placeholders
+  example: logger.info("User {} logged in from {}", userId, ip)
+  when_to_use: Performance-safe logging
+- id: JV-003
+  category: slf4j
+  library: SLF4J
+  name: Exception Logging
+  description: Log exceptions properly
+  example: logger.error("Failed to process", exception)
+  when_to_use: Error handling
+- id: JV-004
+  category: slf4j
+  library: SLF4J
+  name: isDebugEnabled
+  description: Guard expensive logging
+  example: if (logger.isDebugEnabled()) { logger.debug(expensive()) }
+  when_to_use: Performance
+- id: JV-005
+  category: slf4j
+  library: SLF4J
+  name: MDC.put
+  description: Add context to MDC
+  example: MDC.put("requestId", requestId)
+  when_to_use: Request context
+- id: JV-006
+  category: slf4j
+  library: SLF4J
+  name: MDC.clear
+  description: Clear MDC after request
+  example: try { ... } finally { MDC.clear() }
+  when_to_use: Cleanup
+- id: JV-007
+  category: slf4j
+  library: SLF4J
+  name: MDC.getCopyOfContextMap
+  description: Copy MDC for async
+  example: Map<String, String> ctx = MDC.getCopyOfContextMap()
+  when_to_use: Async propagation
+- id: JV-008
+  category: log4j2
+  library: Log4j2
+  name: LogManager.getLogger
+  description: Get Log4j2 logger
+  example: Logger logger = LogManager.getLogger(MyClass.class)
+  when_to_use: Log4j2 projects
+- id: JV-009
+  category: log4j2
+  library: Log4j2
+  name: Async Loggers
+  description: Configure async logging
+  example: <AsyncLogger name="com.example" level="info"/>
+  when_to_use: High-performance
+- id: JV-010
+  category: log4j2
+  library: Log4j2
+  name: JSON Layout
+  description: JSON output layout
+  example: <JsonLayout compact="true" eventEol="true"/>
+  when_to_use: Structured logging
+- id: JV-011
+  category: log4j2
+  library: Log4j2
+  name: Rolling File
+  description: Log rotation appender
+  example: <RollingFile fileName="app.log" filePattern="app-%d.log"/>
+  when_to_use: File management
+- id: JV-012
+  category: log4j2
+  library: Log4j2
+  name: Pattern Layout
+  description: Custom pattern layout
+  example: <PatternLayout pattern="%d{ISO8601} %-5level %logger - %msg%n"/>
+  when_to_use: Custom formatting
+- id: JV-013
+  category: log4j2
+  library: Log4j2
+  name: Lookup
+  description: Dynamic value lookup
+  example: ${ctx:requestId}
+  when_to_use: MDC in patterns
+- id: JV-014
+  category: log4j2
+  library: Log4j2
+  name: Filters
+  description: Log filtering
+  example: <ThresholdFilter level="WARN"/>
+  when_to_use: Conditional logging
+- id: JV-015
+  category: logback
+  library: Logback
+  name: Configuration
+  description: logback.xml setup
+  example: <configuration><appender name="STDOUT" class="ch.qos.logback.core.ConsoleAppender"/>
+  when_to_use: Logback projects
+- id: JV-016
+  category: logback
+  library: Logback
+  name: Encoder
+  description: Pattern encoder
+  example: <encoder><pattern>%d{ISO8601} %msg%n</pattern></encoder>
+  when_to_use: Output formatting
+- id: JV-017
+  category: logback
+  library: Logback
+  name: Rolling Policy
+  description: Time-based rolling
+  example: <rollingPolicy class="TimeBasedRollingPolicy"/>
+  when_to_use: Log rotation
+- id: JV-018
+  category: logback
+  library: Logback
+  name: Async Appender
+  description: Async logging
+  example: <appender name="ASYNC" class="ch.qos.logback.classic.AsyncAppender"/>
+  when_to_use: Performance
+- id: JV-019
+  category: logback
+  library: Logback
+  name: MDC Discriminator
+  description: MDC-based log separation
+  example: <sift>...</sift>
+  when_to_use: Multi-tenant logging
+- id: JV-020
+  category: logback
+  library: Logback
+  name: JSON Encoder
+  description: JSON output
+  example: <encoder class="ch.qos.logback.contrib.json.classic.JsonLayout"/>
+  when_to_use: Structured logging
+- id: JV-021
+  category: general
+  library: any
+  name: Marker
+  description: Log categorization
+  example: Marker marker = MarkerFactory.getMarker("AUDIT"); logger.info(marker, "msg")
+  when_to_use: Log categorization
+- id: JV-022
+  category: general
+  library: any
+  name: Spring Boot Logging
+  description: Spring Boot config
+  example: logging.level.com.example=DEBUG in application.properties
+  when_to_use: Spring applications
+- id: JV-023
+  category: general
+  library: any
+  name: Correlation ID Filter
+  description: HTTP filter for correlation
+  example: '@Component public class CorrelationFilter implements Filter'
+  when_to_use: Web apps
+- id: JV-024
+  category: general
+  library: any
+  name: Feign Logging
+  description: Feign client logging
+  example: '@Bean Logger.Level feignLoggerLevel() { return Logger.Level.FULL; }'
+  when_to_use: API client logging
+- id: JV-025
+  category: general
+  library: any
+  name: Thread Context
+  description: ThreadLocal context
+  example: ThreadContext.put("userId", userId)
+  when_to_use: Thread-safe context

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

@@ -0,0 +1,156 @@
+metadata:
+  skill: logging
+  domain: language_kotlin
+  version: 6.2.0
+  updated: '2026-02-05'
+  migrated_from: language-kotlin.csv
+  patterns_count: 20
+  columns:
+  - pattern_id
+  - category
+  - library
+  - name
+  - description
+  - example
+  - when_to_use
+patterns:
+- id: KT-001
+  category: kotlin-logging
+  library: kotlin-logging
+  name: KotlinLogging.logger
+  description: Create logger
+  example: private val logger = KotlinLogging.logger {}
+  when_to_use: Kotlin projects
+- id: KT-002
+  category: kotlin-logging
+  library: kotlin-logging
+  name: logger.info
+  description: Log at info level
+  example: logger.info { "User $userId logged in" }
+  when_to_use: General events
+- id: KT-003
+  category: kotlin-logging
+  library: kotlin-logging
+  name: logger.debug
+  description: Log at debug level
+  example: logger.debug { "Processing $item" }
+  when_to_use: Debugging
+- id: KT-004
+  category: kotlin-logging
+  library: kotlin-logging
+  name: logger.error
+  description: Log errors with exception
+  example: logger.error(e) { "Failed to process" }
+  when_to_use: Error handling
+- id: KT-005
+  category: kotlin-logging
+  library: kotlin-logging
+  name: logger.warn
+  description: Log warnings
+  example: logger.warn { "Retry attempt $attempt" }
+  when_to_use: Potential issues
+- id: KT-006
+  category: kotlin-logging
+  library: kotlin-logging
+  name: Lazy Evaluation
+  description: Lambda defers evaluation
+  example: 'logger.debug { "Expensive: ${computeDebugInfo()}" }'
+  when_to_use: Performance
+- id: KT-007
+  category: kotlin-logging
+  library: kotlin-logging
+  name: withLoggingContext
+  description: Context propagation
+  example: withLoggingContext("requestId" to reqId) { ... }
+  when_to_use: Request context
+- id: KT-008
+  category: timber
+  library: Timber
+  name: Timber.plant
+  description: Initialize Timber
+  example: Timber.plant(Timber.DebugTree())
+  when_to_use: Android app setup
+- id: KT-009
+  category: timber
+  library: Timber
+  name: Timber.d
+  description: Debug log
+  example: Timber.d("User %s logged in", userId)
+  when_to_use: Android debugging
+- id: KT-010
+  category: timber
+  library: Timber
+  name: Timber.e
+  description: Error log
+  example: Timber.e(exception, "Failed to load data")
+  when_to_use: Android errors
+- id: KT-011
+  category: timber
+  library: Timber
+  name: Timber.i
+  description: Info log
+  example: Timber.i("App started")
+  when_to_use: Android info
+- id: KT-012
+  category: timber
+  library: Timber
+  name: Timber.w
+  description: Warning log
+  example: Timber.w("Network slow")
+  when_to_use: Android warnings
+- id: KT-013
+  category: timber
+  library: Timber
+  name: Custom Tree
+  description: Custom logging tree
+  example: 'class CrashlyticsTree : Timber.Tree() { override fun log(...) }'
+  when_to_use: Crashlytics integration
+- id: KT-014
+  category: timber
+  library: Timber
+  name: Release Tree
+  description: Production tree
+  example: 'class ReleaseTree : Timber.Tree() { /* no debug */ }'
+  when_to_use: Production logging
+- id: KT-015
+  category: timber
+  library: Timber
+  name: Tag Override
+  description: Custom tag
+  example: Timber.tag("CustomTag").d("message")
+  when_to_use: Custom log tags
+- id: KT-016
+  category: android
+  library: Android
+  name: Log.d
+  description: Android SDK logging
+  example: Log.d(TAG, "message")
+  when_to_use: Basic Android logging
+- id: KT-017
+  category: android
+  library: Android
+  name: BuildConfig.DEBUG
+  description: Conditional logging
+  example: if (BuildConfig.DEBUG) Log.d(TAG, msg)
+  when_to_use: Debug builds only
+- id: KT-018
+  category: ktor
+  library: Ktor
+  name: call.application.log
+  description: Ktor server logging
+  example: call.application.environment.log.info("Request received")
+  when_to_use: Ktor applications
+- id: KT-019
+  category: coroutines
+  library: Coroutines
+  name: MDC Context
+  description: Coroutine MDC propagation
+  example: withContext(MDCContext()) { ... }
+  when_to_use: Async context
+- id: KT-020
+  category: coroutines
+  library: Coroutines
+  name: Structured Concurrency
+  description: Log scope lifecycle
+  example: logger.info { "Scope $this starting" }
+  when_to_use: Coroutine debugging

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

@@ -0,0 +1,184 @@
+metadata:
+  skill: logging
+  domain: language_others
+  version: 6.2.0
+  updated: '2026-02-05'
+  migrated_from: language-others.csv
+  patterns_count: 24
+  columns:
+  - pattern_id
+  - category
+  - library
+  - name
+  - description
+  - example
+  - when_to_use
+patterns:
+- id: PHP-001
+  category: monolog
+  library: Monolog
+  name: Logger
+  description: Create Monolog logger
+  example: $logger = new Logger('app')
+  when_to_use: PHP applications
+- id: PHP-002
+  category: monolog
+  library: Monolog
+  name: StreamHandler
+  description: File handler
+  example: $logger->pushHandler(new StreamHandler('app.log', Logger::DEBUG))
+  when_to_use: File logging
+- id: PHP-003
+  category: monolog
+  library: Monolog
+  name: JsonFormatter
+  description: JSON output
+  example: $handler->setFormatter(new JsonFormatter())
+  when_to_use: Structured logging
+- id: PHP-004
+  category: monolog
+  library: Monolog
+  name: RotatingFileHandler
+  description: Log rotation
+  example: new RotatingFileHandler('app.log', 14, Logger::INFO)
+  when_to_use: Log management
+- id: PHP-005
+  category: monolog
+  library: Monolog
+  name: Processor
+  description: Add context
+  example: $logger->pushProcessor(new WebProcessor())
+  when_to_use: Request context
+- id: PHP-006
+  category: psr3
+  library: PSR-3
+  name: LoggerInterface
+  description: Standard interface
+  example: function __construct(LoggerInterface $logger)
+  when_to_use: Interoperability
+- id: PHP-007
+  category: psr3
+  library: PSR-3
+  name: Context Array
+  description: Structured context
+  example: $logger->info('User {user} logged in', ['user' => $userId])
+  when_to_use: PSR-3 context
+- id: RB-001
+  category: stdlib
+  library: Logger
+  name: Logger.new
+  description: Create Ruby logger
+  example: logger = Logger.new(STDOUT)
+  when_to_use: Ruby applications
+- id: RB-002
+  category: stdlib
+  library: Logger
+  name: formatter
+  description: Custom formatter
+  example: logger.formatter = proc { |severity, time, progname, msg| ... }
+  when_to_use: Custom output
+- id: RB-003
+  category: stdlib
+  library: Logger
+  name: level
+  description: Set log level
+  example: logger.level = Logger::INFO
+  when_to_use: Verbosity control
+- id: RB-004
+  category: rails
+  library: Rails
+  name: Rails.logger
+  description: Rails application logger
+  example: Rails.logger.info("message")
+  when_to_use: Rails applications
+- id: RB-005
+  category: rails
+  library: Rails
+  name: Tagged Logging
+  description: Tag-based context
+  example: Rails.logger.tagged('User', user_id) { Rails.logger.info msg }
+  when_to_use: Request context
+- id: RB-006
+  category: semantic
+  library: SemanticLogger
+  name: SemanticLogger
+  description: Structured logger
+  example: 'SemanticLogger[MyClass].info(message: ''msg'', user_id: id)'
+  when_to_use: Structured logging
+- id: RB-007
+  category: semantic
+  library: SemanticLogger
+  name: Named Tags
+  description: Named context
+  example: 'logger.tagged(user_id: id) { logger.info(''action'') }'
+  when_to_use: Rich context
+- id: CPP-001
+  category: spdlog
+  library: spdlog
+  name: spdlog::info
+  description: Log at info level
+  example: spdlog::info("User {} logged in", userId)
+  when_to_use: Modern C++ logging
+- id: CPP-002
+  category: spdlog
+  library: spdlog
+  name: basic_logger
+  description: File logger
+  example: auto logger = spdlog::basic_logger_mt("app", "app.log")
+  when_to_use: File logging
+- id: CPP-003
+  category: spdlog
+  library: spdlog
+  name: rotating_logger
+  description: Rotating file
+  example: auto logger = spdlog::rotating_logger_mt("app", "app.log", 1024*1024, 3)
+  when_to_use: Log rotation
+- id: CPP-004
+  category: spdlog
+  library: spdlog
+  name: async_logger
+  description: Async logging
+  example: auto logger = spdlog::create_async<spdlog::sinks::basic_file_sink_mt>("async")
+  when_to_use: High performance
+- id: CPP-005
+  category: spdlog
+  library: spdlog
+  name: set_pattern
+  description: Custom pattern
+  example: spdlog::set_pattern("[%Y-%m-%d %H:%M:%S] [%l] %v")
+  when_to_use: Custom format
+- id: CPP-006
+  category: glog
+  library: glog
+  name: LOG
+  description: Google logging
+  example: LOG(INFO) << "User " << userId << " logged in"
+  when_to_use: Google-style logging
+- id: CPP-007
+  category: glog
+  library: glog
+  name: LOG_IF
+  description: Conditional logging
+  example: 'LOG_IF(INFO, count > 100) << "High count: " << count'
+  when_to_use: Conditional logs
+- id: EX-001
+  category: logger
+  library: Logger
+  name: Logger.info
+  description: Elixir logger
+  example: 'Logger.info("User login", user_id: user_id)'
+  when_to_use: Elixir applications
+- id: EX-002
+  category: logger
+  library: Logger
+  name: Logger.metadata
+  description: Set metadata
+  example: 'Logger.metadata(request_id: request_id)'
+  when_to_use: Request context
+- id: EX-003
+  category: logger
+  library: Logger
+  name: configure
+  description: Runtime config
+  example: 'Logger.configure(level: :debug)'
+  when_to_use: Dynamic configuration

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

@@ -0,0 +1,191 @@
+metadata:
+  skill: logging
+  domain: language_python
+  version: 6.2.0
+  updated: '2026-02-05'
+  migrated_from: language-python.csv
+  patterns_count: 25
+  columns:
+  - pattern_id
+  - category
+  - library
+  - name
+  - description
+  - example
+  - when_to_use
+patterns:
+- id: PY-001
+  category: stdlib
+  library: logging
+  name: getLogger
+  description: Create module-specific logger
+  example: logger = logging.getLogger(__name__)
+  when_to_use: Every Python module
+- id: PY-002
+  category: stdlib
+  library: logging
+  name: basicConfig
+  description: Simple logging configuration
+  example: logging.basicConfig(level=logging.INFO, format='%(asctime)s %(message)s')
+  when_to_use: Quick setup
+- id: PY-003
+  category: stdlib
+  library: logging
+  name: FileHandler
+  description: Log to file
+  example: handler = logging.FileHandler('app.log')
+  when_to_use: File-based logging
+- id: PY-004
+  category: stdlib
+  library: logging
+  name: StreamHandler
+  description: Log to console
+  example: handler = logging.StreamHandler(sys.stdout)
+  when_to_use: Console output
+- id: PY-005
+  category: stdlib
+  library: logging
+  name: Formatter
+  description: Custom log format
+  example: formatter = logging.Formatter('%(asctime)s - %(name)s - %(levelname)s')
+  when_to_use: Custom formatting
+- id: PY-006
+  category: stdlib
+  library: logging
+  name: dictConfig
+  description: Configure via dictionary
+  example: logging.config.dictConfig(config_dict)
+  when_to_use: Complex configurations
+- id: PY-007
+  category: stdlib
+  library: logging
+  name: Exception Logging
+  description: Log with traceback
+  example: logger.exception("Error occurred")
+  when_to_use: Exception handling
+- id: PY-008
+  category: stdlib
+  library: logging
+  name: Extra Fields
+  description: Add context via extra
+  example: 'logger.info("msg", extra={''user_id'': 123})'
+  when_to_use: Structured context
+- id: PY-009
+  category: structlog
+  library: structlog
+  name: get_logger
+  description: Get structlog logger
+  example: log = structlog.get_logger()
+  when_to_use: Structured logging
+- id: PY-010
+  category: structlog
+  library: structlog
+  name: Bound Logger
+  description: Logger with bound context
+  example: log = log.bind(user_id=123)
+  when_to_use: Request-scoped context
+- id: PY-011
+  category: structlog
+  library: structlog
+  name: Processors
+  description: Transform log events
+  example: structlog.configure(processors=[structlog.processors.JSONRenderer()])
+  when_to_use: Log transformation
+- id: PY-012
+  category: structlog
+  library: structlog
+  name: add_log_level
+  description: Add log level to event
+  example: structlog.processors.add_log_level
+  when_to_use: Level information
+- id: PY-013
+  category: structlog
+  library: structlog
+  name: TimeStamper
+  description: Add ISO timestamps
+  example: structlog.processors.TimeStamper(fmt='iso')
+  when_to_use: Timestamp formatting
+- id: PY-014
+  category: structlog
+  library: structlog
+  name: JSONRenderer
+  description: JSON output
+  example: structlog.processors.JSONRenderer()
+  when_to_use: Production logging
+- id: PY-015
+  category: structlog
+  library: structlog
+  name: ConsoleRenderer
+  description: Pretty console output
+  example: structlog.dev.ConsoleRenderer()
+  when_to_use: Development logging
+- id: PY-016
+  category: structlog
+  library: structlog
+  name: StackInfoRenderer
+  description: Add stack info
+  example: structlog.processors.StackInfoRenderer()
+  when_to_use: Debugging
+- id: PY-017
+  category: structlog
+  library: structlog
+  name: ExceptionPrettyPrinter
+  description: Format exceptions
+  example: structlog.processors.ExceptionPrettyPrinter()
+  when_to_use: Error logging
+- id: PY-018
+  category: loguru
+  library: loguru
+  name: logger.add
+  description: Add sink destination
+  example: logger.add('file.log', rotation='500 MB')
+  when_to_use: File logging
+- id: PY-019
+  category: loguru
+  library: loguru
+  name: Rotation
+  description: Automatic log rotation
+  example: logger.add('file.log', rotation='1 day')
+  when_to_use: Log management
+- id: PY-020
+  category: loguru
+  library: loguru
+  name: Retention
+  description: Log retention policy
+  example: logger.add('file.log', retention='10 days')
+  when_to_use: Disk management
+- id: PY-021
+  category: loguru
+  library: loguru
+  name: Serialization
+  description: JSON serialization
+  example: logger.add(sink, serialize=True)
+  when_to_use: Structured output
+- id: PY-022
+  category: loguru
+  library: loguru
+  name: logger.catch
+  description: Decorator for exception logging
+  example: '@logger.catch; def my_func(): ...'
+  when_to_use: Automatic exception capture
+- id: PY-023
+  category: loguru
+  library: loguru
+  name: Lazy Evaluation
+  description: Defer expensive evaluation
+  example: 'logger.debug(''Result: {result}'', result=lambda: expensive())'
+  when_to_use: Performance
+- id: PY-024
+  category: general
+  library: any
+  name: JSON Formatter
+  description: Custom JSON formatter
+  example: 'class JsonFormatter(logging.Formatter): ...'
+  when_to_use: JSON logging with stdlib
+- id: PY-025
+  category: general
+  library: any
+  name: Context Filter
+  description: Add request context
+  example: 'class ContextFilter(logging.Filter): ...'
+  when_to_use: Request-scoped logging