Did all that make sense?

For the most part, Yes. But without really seeing all the documentation and being able to try things out, I can't really say how much sense it makes, as I may be mis-interpreting you.

If there is a logical hole in my implementation then I'd love to hear about it sooner rather than later.

Again, nothing I can see from what you describe, but again, the sooner we can all read the real docs, the better we could tell.

I just hope that there isn't some kind of limiting flaw that I have missed that cripples its capabilities.

Thats what version 0.02 is for :). A few things I have learned after uploading several modules to CPAN (and there are more to come, I am converting our entire internal framework to open source CPAN modules). 1) Very few people will jump to use version 0.01 of a brand new modules from an unknown author (I know I don't), 2) You will never know who is using/downloading your module, as there is no way to tell really (well there are ways, but they will get your banned by merlyn) and 3) spell check your documentation :)