task_symbolic__braille_cell__braille_word_read_label¶
1) Identity¶
- Domain:
symbolic - Scene id:
braille_cell - Scene:
braille_cell - Task id:
task_symbolic__braille_cell__braille_word_read_label - Objective: choose the word option encoded by a multi-cell Braille plate.
Program Contract¶
Program: braille_cell.word_read(scene=braille_cell, scope=source_braille_word_plate_and_four_word_options, output=option_label)
Candidate set: the four visible word option cards labeled A..D.
Operands: the raised-dot patterns in each source Braille cell and the candidate lowercase option words.
Operation: decode the source Grade 1 Braille word and select the unique option word that matches it.
Output binding: answer is the selected option letter.
Annotation witnesses: a bbox_map with source_plate and selected_option roles.
Query ids: single.
Reasoning Operations¶
Families: transformation
2) Scene + Task Contract¶
- Public branch metadata:
query_id - Supported
query_id:single - Internal prompt/query key:
braille_word_read_label - Supported non-semantic visual axes:
scene_variant:clean_card|notebook_card|exam_scan- shared symbolic background/noise style
answer_gt.type:string- Answer schema:
string, one capital-letter option label fromA..D. annotation_gt.type:bbox_map- Annotation schema:
bbox_map - Scene contract:
- one source Braille word plate is shown,
- four visual word options are labeled
A..D, - every option word has the same length as the source word,
- all option words share at least the first character, so the first Braille cell alone cannot identify the answer,
- exactly one option is the lowercase word encoded by the Braille plate,
- words use Grade 1 uncontracted lowercase Braille letters only,
- generated words are sampled from
trace_tasks.tasks.shared.word_assets, - word length support is
3..5.
3) Prompt Contract¶
- Bundle:
symbolic_braille_cell_v1 scene_key:braille_celltask_key:braille_word_read_label- Required slots:
- scene:
object_description - answer output:
json_output_contract_answer_only,answer_hint,json_example_answer_only - answer+annotation mode:
json_output_contract,annotation_hint,answer_hint,json_example - Modes:
answer_only,answer_and_annotation - Options are visible word cards in the image, not prompt-only choices.
4) Annotation + Trace Contract¶
- Prompt-facing annotation is a
bbox_mapwith two semantic roles: source_plate: bbox around the source Braille word plate,selected_option: bbox around the correct visual word option.- Distractor option bboxes, individual Braille cells, individual dots, text bboxes, labels, and panel chrome are not prompt-facing annotation.
projected_annotationincludesbbox_mapandpixel_bbox_map.render_mapincludes:item_bboxes_pxdot_centers_pxraised_dot_centers_pxcell_dot_centers_pxexecution_trace.braille_metadatarecords the target word, word length, target cell patterns, correct option label/id, option words, and shared-prefix sampling metadata.
5) Determinism + Tests¶
- Deterministic sampling/rendering from
instance_seed. - Answers and annotation come from the same finalized source/option layout.
- Behavior/trace/prompt tests:
tests/test_symbolic_braille_tasks.py - Source-layout contract tests:
tests/test_public_source_layout_contracts.py