[Update] Refactor and enhance with ID generation, trace linking, formatting, and export improvements

[patrick204nqh]

Description

This PR introduces a series of improvements, refactors, and new features to enhance the functionality, maintainability, and usability.

Major Features

• ID Generation:

  • Introduced IDGenerator for centralized and reusable unique ID creation.
  • Enhanced trace linking with the new TraceLinker module, which adds robust logging for invalid links and better trace correlation.

• Formatting Enhancements:

  • Added helper modules for:
    • Colorization.
    • Depth formatting.
    • Method name formatting.
    • Parameter formatting.
  • Introduced KeyValueFormatter for structured trace formatting.
  • Added ValueTruncator to handle large trace data efficiently.

• Export Improvements:

  • Added support for YAML and TXT export formats.
  • Enhanced color formatting options for better readability.

Refactors

• Improved logging and exporting mechanisms by introducing:
  • LoggingManager for centralized logging.
  • ExportManager for modular export handling.
• Refactored the BaseFormatter to extend the new TraceDataFormatter.
• Updated ValueTruncator and other components for stricter length validation and RBS type definitions.

Dependency Updates

• Added the Steep gem for type checking, ensuring better static analysis.

Miscellaneous Enhancements

• Improved trace output formatting with depth and result enhancements.
• Initial setup for TraceViz module, including adapters, collectors, and tracers, with RBS signatures.

Bug Fixes

• Fixed validation logic for truncate_length to ensure it is always an integer, resolving potential type-related issues.

Type of Change

Check all that apply:

• Bug fix (non-breaking change which fixes an issue)
• New feature (non-breaking change that adds functionality)
• Refactor (improves code structure without changing functionality)
• Breaking change (fix or feature that changes existing behavior)
• Documentation update
• Other (dependency updates and type checking)

How Has This Been Tested?

The following tests and validations have been performed to ensure stability and correctness:

• Added or updated unit tests for all new features and changes.
• Verified export functionality for YAML and TXT formats.
• Checked color formatting across different terminal environments.
• Ran bundle exec rspec to confirm all tests pass.
• Tested changes across multiple Ruby versions for compatibility.
• Verified type-checking with the Steep gem.

Checklist

• I have followed the Ruby Style Guide.
• I have performed a self-review of my code.
• I have added or updated tests as needed.
• All existing and new tests pass.
• I have updated the documentation (if needed), including README.md and CHANGELOG.md.
• I have considered the impact on users and documented any required changes or upgrades.

Deployment Notes

• No

Related Issues

• No

Screenshots (if applicable)

N/A