[wandooadzer-cmyk]

Add a comprehensive deprecation warning system for CLI flags in the GasGuard analyzer platform. This implementation provides:

• Automatic detection of deprecated flag usage in CLI arguments
• Severity-based warnings (HIGH, MEDIUM, LOW) with color-coded output
• Structured JSON logging to stderr for operational visibility
• Metrics collection for tracking deprecation adoption patterns
• Commander.js integration via hooks
• Environment variable configuration overrides
• Optional process failure on high-severity deprecations

Example deprecated flags:

• --analyze-local -> scan (HIGH severity)
• --no-progress -> --quiet (MEDIUM severity)
• --fix-preview -> config: output.fixPreview (LOW severity)

The system is designed with:

• Tenant isolation: stateless, thread-safe design
• Concurrent worker safety: no shared mutable state
• Backward compatibility: deprecated flags continue to work
• Predictable results: deterministic detection logic
• No PII/secrets in logs

Closes #1277
Closes #1276
Closes #1278
Closes #1274

Tests included:

• Unit tests for config, detector, logger, metrics, integration
• Integration tests for CLI flow, worker concurrency, boundaries
• E2E tests for component boundaries and failure scenarios

Closes: IMPLEMENT_DEPREICATION_WARNINGS_FOR_CLI_FLAGS

[drips-wave]

@wandooadzer-cmyk Great news! 🎉 Based on an automated assessment of this PR, the linked Wave issue(s) no longer count against your application limits.

You can now already apply to more issues while waiting for a review of this PR. Keep up the great work! 🚀

Learn more about application limits