get_health
Retrieve code-health scores and findings from stored analysis: get a dashboard overview, or ranked file-level findings with refactoring and performance queues.
Instructions
Code-health scores and findings from stored analysis.
No ``targets`` returns a dashboard; targets return ranked files and findings.
Never recomputes health: commit changes, then run ``repowise update``.
Every block and accepted value: docs/agent/MCP_TOOLS.md.
Args:
targets: file paths or ``module:<name>``. Empty means dashboard;
unmatched ones land in ``unresolved``, surviving ``only``.
include: ``biomarkers`` | ``refactoring`` | ``trend`` | ``coverage`` |
``accuracy`` | ``signals`` | ``churn_complexity``, or a dimension.
``performance`` and ``refactoring`` add their queues.
only: keys to keep; identity, counts and recovery survive.
``biomarkers``, ``accuracy`` and ``refactoring`` alias their block
key. ``performance``, ``defect`` and ``maintainability`` do not:
they filter rows and land in ``unknown_only_keys``.
repo: usually omitted.
limit: max rows per ranked list, ``0`` for none.
cursor: zero-based offset into a ranked list.
finding_id: stable ``id`` from a health finding.
plan_id: stable ``id`` from a refactoring plan.
opportunity_id: ``perf...`` or ``refop...`` id from a directive or
queue: the unit, its steps or plan, and evidence paged by
``only=["*_evidence"]``. Excludes the two ids above.
refactoring_view: ``diversified`` (default) | ``canonical`` |
``file_spread``; refactoring_type / _confidence / _effort filter.
performance_view / _context / _boundary / _confidence / _sort: queue
projection and filters; the facets list them.Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| only | No | ||
| repo | No | ||
| limit | No | ||
| cursor | No | ||
| include | No | ||
| plan_id | No | ||
| targets | No | ||
| finding_id | No | ||
| opportunity_id | No | ||
| performance_sort | No | ||
| performance_view | No | ||
| refactoring_type | No | ||
| refactoring_view | No | diversified | |
| refactoring_effort | No | ||
| performance_context | No | ||
| performance_boundary | No | ||
| performance_confidence | No | ||
| refactoring_confidence | No |
Output Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| result | Yes |