Reports
-------

Overview
~~~~~~~~
Reports are the final output stage of analysis pipelines, serving as the destination for processed items that need to be presented or exported. They provide various methods to present the analysis results, from simple data dumps to complex API integrations.

Output Formats
~~~~~~~~~~~~~~
Reports can generate output in multiple formats:
* YAML dumps for structured data
* REST API calls for integration with external systems
* Custom formatters for specialized output needs

Item Filtering
~~~~~~~~~~~~~~
Reports use a labeling system to determine which items should be included. Items can be filtered using:
* Dedicated filters with customizable logic
* Label-based selection criteria
* Threshold-based conditions

Example Use Case
~~~~~~~~~~~~~~~~
A cyclomatic complexity report might only include functions where:
* The complexity exceeds a defined threshold
* The item is labeled as "function" or "method"
* The analysis indicates potential maintenance issues

This selective reporting ensures that only relevant items appear in the final output, making reports more focused and actionable.