docs: install.sh + learn/ walkthrough series + full README
install.sh: cross-platform Crystal version check, libpcre2 dependency
hint, shards install + release build, optional install to PATH via
INSTALL_TO_PATH=1.
learn/:
00-OVERVIEW.md - quick start + three-tier demo path
01-CONCEPTS.md - rotation theory, real breaches (SolarWinds,
Codecov, LastPass, Storm-0558, Snowflake/UNC5537),
framework controls
02-ARCHITECTURE.md - bus + plugin diagrams, three-layer audit integrity,
AEAD envelope encryption layer breakdown
03-IMPLEMENTATION.md - code walkthrough pointing at each key file
04-CHALLENGES.md - 10 ranked extension challenges (PG ALTER USER
rotator, Slack notifier, ML-KEM hybrid wrap,
OpenTimestamps anchoring, SPIFFE workload identity,
JIT credential broker, etc.)
README.md: full hero + badges + quick start + subcommand cheatsheet +
flagship rotator table + ASCII architecture diagram + project layout
+ links to learn/ + test suite instructions.
51287d3f7d