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

1.5 KiB

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.