Description

This pull request introduces improved error handling and logging throughout the codebase, making it easier to diagnose and track down issues related to invalid parameters and missing data. Additionally, it adds a new feature to optionally include piece content when handling tasks. The most important changes are grouped below:

Error Handling and Logging Improvements:

• Added detailed error logging using the error! macro in multiple locations where invalid parameters or missing fields are detected, such as missing headers, invalid addresses, missing persistent cache fields, and missing or invalid resource pieces. This provides clearer diagnostics for debugging and operational monitoring. [1] [2] [3] [4] [5] [6] [7] [8] [9] [10] [11] [12] [13] [14]
• Updated imports to include the error macro from tracing where needed.

Task and Piece Handling Enhancements:

• Added a need_piece_content boolean parameter to the Task struct and related logic, allowing tasks to optionally fetch and include piece content from local storage. This is useful for scenarios where the content is required for further processing. [1] [2]
• Implemented logic to read piece content from local storage into the piece object when need_piece_content is set, including error handling for read failures.

These changes collectively improve the robustness and observability of the code, especially in error scenarios, and add flexibility in how task pieces are managed.

Related Issue

Motivation and Context

Screenshots (if appropriate)