CarterPerez-dev
99d89b3050
docs(README): match repo project pattern ( #27 intermediate)
...
Replace MIT placeholder with the standard intermediate-project README
shape used by sbom-generator, secrets-scanner, etc:
- Block-character ASCII banner (CRE)
- Project #27 / Crystal / AGPLv3 / Postgres badges
- One-line description quote -> learn modules pointer
- What It Does (bulleted feature list)
- Quick Start with both clone-and-build and install.sh paths
- just hint with install one-liner
- Demo tiers + daemon usage code blocks
- Flagship Rotators table
- ASCII architecture diagram
- Three-layer audit log diagram (own section)
- Stack section (language + deps + FFI note + testing)
- Configuration pointer (CONFIGURATION.md)
- Learn modules table
- AGPL 3.0 license footer
Also swapped LICENSE from MIT to AGPL v3 to match the rest of the
intermediate projects.
2026-04-29 01:50:30 -04:00
CarterPerez-dev
73e3488edc
chore: replace Makefile with justfile to match repo convention
...
Justfile mirrors the haskell-reverse-proxy pattern (grouped recipes:
build, run, demo, test, quality, db, util). 33 recipes covering full
lifecycle - including parameterized recipes (cre rotate ID, cre policy
show NAME) that read more naturally as 'just rotate ...' than as
make targets.
User-edited docker-compose.yml port mappings preserved
(postgres:18 on 6022, localstack on 45666, vault on 18201,
fake-github on 7115).
2026-04-29 01:28:37 -04:00
CarterPerez-dev
51287d3f7d
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.
2026-04-29 01:21:17 -04:00
CarterPerez-dev
e69cc301cf
feat(cre): bootstrap Crystal project shell
...
- shard.yml with db, pg, sqlite3, tourmaline (deps), webmock (dev)
- Makefile with build/test/format/lint/demo targets
- .gitignore, .editorconfig, LICENSE (MIT), README skeleton
- ameba lint deferred until libpcre3-dev is available on this env
2026-04-28 18:05:36 -04:00