Skip to main content

Module display

Module display 

Source
Expand description

Short-form ID rendering and input parsing per JOT-002F-4D.

Full IDs follow joy-core’s ADR-027 scheme: TODO-XXXX-YY. For display the tool shows only the middle counter without the acronym prefix, leading zeros, or the title-hash suffix: TODO-00A1-EA -> #A1. When two tasks in the same workspace share a counter (rare, caused by concurrent adds on different devices before sync), the affected rows keep the suffix so they remain addressable: #A1-EA, #A1-7F.

Functions§

format_ids
Render short display IDs for a list of full IDs, expanding only the rows whose counters collide within the list. Returns one string per input, in the same order.
normalize_id_input
Normalize any of #A1, A1, a1, TODO-00A1, TODO-00A1-EA, #A1-EA to a form find_task_file understands (uppercase, with TODO- prefix and 4-digit counter).
short_id
Render a short display ID for a single full ID, without disambiguation. Use format_ids when rendering a list where collisions must be handled.