DecisionsPlatform
ADR-0002: Fold heading runs into the composition, keeping the last heading's comp_id
Page actions
- View as Markdown (opens in a new tab)
- Ask ChatGPT (opens in a new tab)
- Ask Claude (opens in a new tab)
ChatGPT and Claude are third-party services. The link gives them this page's public address and a short instruction. This site records nothing.
Preview: the published page may be older or missing.
Why a run of heading lines folds into the composition it opens, keeping the last heading's comp_id and leaving permanent gaps.
https://docs.gurbanisoul.com/adr/0002-comp-id-keep-last-regroup/
ADR-0002: Fold heading runs into the composition, keeping the last heading’s comp_id
Status: accepted (2026-09-15)
Context
Every heading line had its own comp_id, so a title line followed by
a separate ੴ invocation became an orphan one-line composition; the shabad sheet
never showed the printed title (e.g. Ang 712). 677 such orphans corpus-wide.
Decision
A run of consecutive heading lines opens ONE composition with the
body it introduces (build_corpus.py post-pass 1b). The run adopts the comp_id
of its last heading — the one already holding the body — so no body line’s
comp_id changes; vacated ids become permanent gaps. Rejected the alternative
(contiguous renumber), which would break every stored bookmark/deep link.
Three closing rubrics are excluded and stay one-line comps.
Consequences
Distinct comps 5,380 → 4,706 with gaps; max stays 5,380.
Saved verses, Spotlight ids, deep links, and analytics keyed on comp_id remain
valid. Proven by pipeline/verify_regroup.py (scripture byte-identical).
Sri Guru Granth Sahib Ji — Knowledge Base wiki. Generated from commit c3d9360. Updated 25 September 2026. This copy may be out of date; the page is at https://docs.gurbanisoul.com/adr/0002-comp-id-keep-last-regroup/