docs: Add comprehensive JSDoc comments to logger.ts

[continue]

Summary

This PR adds comprehensive JSDoc documentation to all functions, methods, classes, and enums in src/helpers/logger.ts.

Changes

• ✅ Added JSDoc comments to LogLevel enum with description
• ✅ Added JSDoc comments to Logger class with usage example
• ✅ Documented all public methods: debug(), info(), warn(), error(), setLevel(), getLevel()
• ✅ Documented private methods: formatMessage(), shouldLog()
• ✅ Added documentation for exported functions: createLogger(), parseLogLevel(), formatError()
• ✅ Included parameter descriptions and return types for all functions
• ✅ Added usage examples where appropriate

Documentation Coverage

• Enum: 1/1 documented (LogLevel)
• Class: 1/1 documented (Logger)
• Methods: 8/8 documented (all Logger methods)
• Functions: 3/3 documented (all exported functions)

All functions now have:

• Parameter descriptions with types
• Return type documentation
• Practical usage examples
• Clear descriptions of behavior

---

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