Skip to content

Add progressive tabular stats annotations#83

Merged
jcushman merged 1 commit into
mainfrom
pr/tabular-stats-annotator
Jun 3, 2026
Merged

Add progressive tabular stats annotations#83
jcushman merged 1 commit into
mainfrom
pr/tabular-stats-annotator

Conversation

@jcushman
Copy link
Copy Markdown
Contributor

@jcushman jcushman commented Jun 3, 2026

Summary

  • add an opt-in binoc.tabular_stats_annotator transformer for numeric distribution shifts in tabular artifacts
  • add progressive renderer annotations to the SDK/IR as namespaced {package, key, value} records, with Rust and Python helper APIs
  • render annotations generically in Markdown by JSON shape instead of adding stats-specific Markdown handling
  • publish distribution shifts as simple binoc/distribution_shifts string-list annotations
  • add the distribution-shift test vector, regenerate affected ABI/changeset/schema/docs outputs, and document the annotation contract in an ADR

Design notes

  • DiffNode::annotate_from(package, key, value) is the explicit annotation writer. The SDK intentionally does not provide annotate(key, value) yet because plugin calls do not have an ambient current-package identity.
  • Annotation values stay progressively typed JSON. There is no explicit version field yet; renderers duck-type the generic value shape until a package/key-specific contract is worth stabilizing.
  • Markdown intentionally has no special handling for distribution stats. It only suppresses content_summary / tabular_summary from generic output because those are already consumed as move/correlation trailer text.

@jcushman jcushman force-pushed the pr/tabular-stats-annotator branch from ea69c8a to cee7a69 Compare June 3, 2026 13:36
@jcushman jcushman changed the title Add opt-in tabular distribution stats annotator Add progressive tabular stats annotations Jun 3, 2026
@jcushman jcushman force-pushed the pr/tabular-stats-annotator branch from cee7a69 to 3a33038 Compare June 3, 2026 13:58
@jcushman jcushman merged commit 089f324 into main Jun 3, 2026
10 checks passed
@jcushman jcushman deleted the pr/tabular-stats-annotator branch June 3, 2026 14:00
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant