So I have some old Black & Decker tools that use the 18V HPB18-OPE battery (yes, I know — why don't I replace them with newer tools? Because I refuse to discard a tool that still works reliably and safely). Now, one might think that newer batteries that are HPB18-OPE-compatible would actually be compatible, but...nay nay! It seems that the replacement battery will not fully insert into quite a few older tools.
Doing Google and AI searches didn't help--they pretty much all said the same thing: you can't fix it; just Ebay for the older OEM battery and hope you can find one and/or dump the old tool and buy a newer one.
Being a machinist and QA inspector, I decided on a different route: identify why the new one wouldn't fit. If you look at the original and replacement batteries and the battery port, there seems to be no reason why the replacement battery jams up about an inch from fully seating. It took me a while to find out why, too.
Two plastic tabs sit on the sides of the copper contact prongs. They line up just fine with their receiving slots on the tool. However...the ones for the replacement batteries sit higher than the ones for the OEM batteries. I carefully held the replacement battery in a vice, then flat-filed them down flush. Voila!
A little whack fully seats the battery (I'll Dremel them down a bit lower to make additional clearance), and they pop back out without a hitch.