working and documented plugin. passes three included tests.