| name | run-history |
| description | Read Runx's native receipt history and skill catalog, then return deterministic run outcomes, catalog test coverage, and governance follow-ups without model-authored metrics. |
| runx | {"category":"data"} |
Run History
Read the local Runx ledger through runx history --json and the installed
catalog through runx list skills --ok-only --json. The runner computes the
report itself; it does not ask an agent to invent commands or transcribe counts.
Use it for operational questions about recent Runx activity, failed or blocked
runs, pending runs, frequently used receipt subjects, and skill entries without
fixtures or inline harness cases. Use audit-receipt or review-receipt to
inspect one suspicious run, and least-privilege when receipt-backed authority
usage is available for grant attenuation.
Evidence boundary
- Live execution reads only the native history and catalog JSON projections.
- History reads are bounded to 1,000 rows by default and 10,000 at most.
history_receipts, pending_runs, and catalog_items are replay inputs for
harnesses and controlled analysis; when supplied, no native history or list
command is executed.
- Empty history returns
needs_more_evidence rather than a healthy verdict.
closed_rate is the share of terminal receipt rows whose status is closed.
refusal_rate counts blocked and declined terminal rows. It is reported
as an observation, not automatically treated as a defect.
- Catalog coverage is the number of native catalog entries declaring at least
one fixture or inline harness case. It is not a maturity grade.
Output
history_report contains:
- the exact resolved query and native source commands;
- terminal and pending counts, status counts, closed/refusal rates;
- the most frequent receipt subjects;
- catalog entry and test-coverage counts;
- bounded recommendations routed to
review-receipt, audit-receipt, or
skill-lab harness;
- limitations when native projections cannot support a stronger claim.
This skill never executes another skill, changes a grant, or mutates the
receipt store.