Once notorious for bedbugs and crime, the Regent Park social housing development has been transformed with a $1bn revitalisation – and more than a few luxury apartments. But has it managed to avoid social cleansing?