Add comprehensive docs: HPD algorithm deep-dive, usage scenarios, ben…

…chmarks

- Full README with algorithm explanation, benchmark methodology,
  usage scenarios (pentest, CTF, red team, AD audit, policy validation),
  extension guide (languages, patterns, slot types, hash types), roadmap
- Separate HPD-ALGORITHM.md with formal model, mathematical foundation,
  comparison with PCFG/Markov/dictionary approaches, limitations analysis
- Updated metadata (shard.yml, LICENSE, .gitignore)

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

Add comprehensive docs: HPD algorithm deep-dive, usage scenarios, ben…

…chmarks

- Full README with algorithm explanation, benchmark methodology,
  usage scenarios (pentest, CTF, red team, AD audit, policy validation),
  extension guide (languages, patterns, slot types, hash types), roadmap
- Separate HPD-ALGORITHM.md with formal model, mathematical foundation,
  comparison with PCFG/Markov/dictionary approaches, limitations analysis
- Updated metadata (shard.yml, LICENSE, .gitignore)

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>