Replace minimal README with full project docs (setup, usage, architecture). Remove trivial tests and add meaningful edge case coverage.