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-EAto a formfind_task_fileunderstands (uppercase, withTODO-prefix and 4-digit counter). - short_
id - Render a short display ID for a single full ID, without disambiguation.
Use
format_idswhen rendering a list where collisions must be handled.