chart-contract v0.2.0

chart-contract v0.2.0

v0.2.0 turns chart-contract into a practical agent and CI gate for claim-first analytical charts, while expanding the audited chart surface into distributions and statistical diagnostics.

Highlights

• Audit Vega-Lite specs from disk with stable READY, REVIEW, and BLOCK verdicts.
• Supply CSV or JSON data and emit text, JSON, or Markdown reports.
• Use CI-friendly exit behavior, including warnings-as-errors and explicit fail thresholds.
• Build audited histogram, boxplot, violin, QQ, ECDF, and residual charts.
• Catch missing fields, invalid quantitative encodings, unusable sample sizes, misleading baselines, crowded arc charts, causal overreach, and unsupported intents.

Statistical diagnostic guardrails

• QQ plots require a supported fitted reference line.
• Severe QQ tail departure warns against overconfident normality claims.
• Residual plots require a zero reference line.
• Obvious fitted-value structure warns against “no pattern” claims.
• Tiny diagnostic samples block interpretation.

Runnable trap fixtures demonstrate the expected outcomes:

• severe QQ tails → REVIEW
• missing QQ reference line → BLOCK
• obvious residual structure → REVIEW
• four-point residual diagnostic → BLOCK

Design boundary

The release remains deterministic and inspectable. It does not claim to prove causality, normality, randomness, or model adequacy, and it does not add automatic chart correction, dashboards, external data fetching, or a broad plotting abstraction.