I fully understand that.
Larian does have a weird and sometimes unexpected way of implementing things altogether, which makes looking up how things work very hard, because a lot of things are scattered all over the place.
Setting up a central companion dismiss procedure just to ignore it and manually dismiss Bairdotr in the Jareth fight is also an example of that, not to mention the henchman thing, which is not a 'preview', as one might expect but a constant loop of hiring and dismissing until finally one of them is actually hired or the dialog is canceled.
(I still have no clue what the OnCompanionDismissed() call really does.)
... but I am optimistic, that by the time DOS/9 public beta will be renamed to 'DOS/9 Classic' when DOS/9 EE comes out, we might finally get some documentation for modding and have cleaned up code ;-)
(Despite all my rants, I still give Larian a lot of credit, because public beta aka classic was already an amazing game with amazing stability. And some people like me had to wait 10+ years for such a turn based combat game since The Temple of Elemental Evil came out - which was way too short - some time 2004 I think. And of all modern games, DOS is still unique in that respect and beats any Pillars or whatever every day and by far ;-)