task_charts__scatter_cluster__cluster_spread_extremum_label

Contract

1. Domain: charts
2. Scene id: scatter_cluster
3. Task id: task_charts__scatter_cluster__cluster_spread_extremum_label
4. Supported query_ids: largest_horizontal_spread_label, smallest_horizontal_spread_label, largest_vertical_spread_label, smallest_vertical_spread_label, largest_overall_spread_label, smallest_overall_spread_label

Implementation

1. Registered class: trace_tasks.tasks.charts.scatter_cluster.cluster_spread_extremum_label.ChartsScatterClusterSpreadExtremumLabelTask
2. Prompt bundle: src/trace_tasks/resources/prompts/charts/scatter_cluster/charts_scatter_cluster_v1.json
3. Generation is deterministic from instance_seed, explicit params, prompt bundle, renderer config, and code versions.

Program Contract

Program: argextreme_label(cluster, spread(cluster, axis), direction); scene=scatter_cluster; scope=cluster_spread_extremum_label

Candidate set: the visible scatter points, clusters, and cluster labels inside the cluster_spread_extremum_label objective scope. Operands: prompt-bound labels, categories, series names, thresholds, intervals, references, and encoded chart values, plus the active query id's comparator, direction, target role, or extremum focus when present. Operation: evaluate argextreme_label over the candidate set using the filters, comparisons, aggregations, rankings, projections, or counterfactual edits named in the program expression; generation enforces a unique final answer. Output binding: answer is the string value bound by string. Annotation witnesses: bbox witnesses bound by see_annotation_contract. Annotation should mark the answer cluster hull, not the legend row or cluster label text. Renderer context such as legends, axes, decorative labels, titles, and distractor text is metadata unless the task explicitly asks for it as annotation. Query ids: largest_horizontal_spread_label, smallest_horizontal_spread_label, largest_vertical_spread_label, smallest_vertical_spread_label, largest_overall_spread_label, smallest_overall_spread_label.

Reasoning Operations

Families: ranking, formula_evaluation

Annotation Contract

1. Answer schema: string.
2. Annotation schema: bbox.
3. Annotation should mark the answer cluster hull, not the legend row or cluster label text.
4. Renderer context such as legends, axes, decorative labels, titles, and distractor text is metadata unless the task explicitly asks for it as annotation.

Query Details

Query id	Program arguments	Answer schema	Annotation schema
largest_horizontal_spread_label	axis=horizontal; direction=largest	string	bbox
smallest_horizontal_spread_label	axis=horizontal; direction=smallest	string	bbox
largest_vertical_spread_label	axis=vertical; direction=largest	string	bbox
smallest_vertical_spread_label	axis=vertical; direction=smallest	string	bbox
largest_overall_spread_label	axis=overall; direction=largest	string	bbox
smallest_overall_spread_label	axis=overall; direction=smallest	string	bbox