Add comprehensive JSDoc documentation to logger module

[continue]

📝 Documentation Enhancement

This PR adds comprehensive JSDoc comments to all public APIs in the src/helpers/logger.ts module.

Changes Made

• ✅ Added JSDoc comments to the LogLevel enum with descriptions for each level
• ✅ Documented the Logger class with full parameter and return type information
• ✅ Added usage examples to all public methods (debug, info, warn, error)
• ✅ Documented private methods for completeness
• ✅ Added documentation to factory function createLogger
• ✅ Documented utility functions parseLogLevel and formatError
• ✅ Included proper JSDoc tags: @module, @class, @enum, @param, @returns, @example

Documentation Highlights

All public APIs now include:

• Parameter descriptions with types
• Return type documentation
• Usage examples demonstrating typical use cases
• Clear explanations of behavior and purpose

Example

/**
 * Logs an error message with optional Error object.
 * @param {string} message - The error message to log
 * @param {Error} [error] - Optional Error object to log with stack trace
 * @example
 * logger.error('Failed to connect', new Error('Connection refused'));
 */
error(message: string, error?: Error): void

---

This agent session was co-authored by bekah-hawrot-weigel and Continue.