harness-observability

What problem does it solve?

Provides a structured, evidence-based way to verify that a project's harness is actually running, tracking operational cadences, surfacing trends between snapshots, and detecting when observability itself is failing so teams can act before drift accumulates.

Core Features & Use Cases

• Operational cadence checks that verify scheduled mechanisms (audit, GC, reflection, mutation testing) actually executed and surface overdue activities.
• Trend computation by diffing human-readable snapshots to highlight deltas and multi-period trends for reviews.
• Telemetry export guidance and a reference export script to emit OpenTelemetry metrics for external dashboards.
• Meta-observability: five automated checks (snapshot currency, cadence compliance, learning flow, GC effectiveness, trend direction) that feed a README health badge and meta section.
• Use Case: Run a harness snapshot before a quarterly review to baseline enforcement ratio, mutation trends, and learning promotions, then export metrics to Grafana.

Quick Start

Run the /harness-health command to generate the latest snapshot, compute trends against the previous snapshot, and update the README health badge.