gravity-wells/README.md
Rene Nochebuena bc3c5aa846
All checks were successful
Go CI/CD / go-ci (push) Successful in 36s
Add CQRS library 'Singularity' with core handlers and tests
Introduces the 'Singularity' implementation, a CQRS Bus that supports commands, queries, and events, along with middleware extensibility. Includes comprehensive tests, modular files for commands, queries, and events, as well as CI/CD workflows.
2025-04-26 22:25:23 -06:00

48 lines
1.5 KiB
Markdown

# Gravity Wells
_Forge gravity into your code. Shape time, distort space, and carve legacy into the architecture of tomorrow._
**Gravity Wells** is a lightweight CQRS and Event-Driven library, built to resonate with the spirit of domain-driven architectures.
At its core lies the **Singularity** โ€” a gravitational nexus where commands, queries, and events intertwine, bending the causal fabric of your systems.
---
## โœจ Philosophy
- **Commands** bend domain realities.
- **Queries** capture the light escaping from the core.
- **Events** ripple as gravitational waves across time.
Gravity Wells does not impose structures โ€” it unlocks potential.
It does not dictate architectures โ€” it forges paths.
---
## ๐Ÿง  Core Principles
- **Hexagonal Architecture (Ports & Adapters) friendly**
- **Built for CQRS, Event Sourcing, and Saga orchestration**
- **Extensible through Command, Query, and Event Middlewares**
- **Zero external dependencies: pure minimalism**
---
## ๐Ÿช Infinite Expansion
Gravity Wells is only the first fragment of a greater constellation:
- `gravitywells/sagas`: Saga orchestrators, weaving constellations of process.
- `gravitywells/observatory`: Observability to record the curvatures of events.
- `gravitywells/eventstorm`: A DSL for mapping event storms across untamed domains.
---
> _Commands are gravity wells.
> Queries are photons escaping.
> Events are echoes traveling eternally across the fabric of systems._
---
# ๐Ÿ“œ License
**MIT** โ€” because knowledge, like gravity, belongs to everyone.