Res cli v2#1935

Draft

tomaszpatrzek wants to merge 39 commits into

Contributor

tomaszpatrzek commented Apr 22, 2026

Add ruby_event_store-cli contrib gem

A new CLI tool for inspecting a RubyEventStore/RailsEventStore event store from the terminal. Built entirely on
the public RubyEventStore::Client API — no ActiveRecord internals, no raw SQL.

Commands

res stream events STREAM — list events in a stream with filtering by type, time, position; --follow/-f to
tail live
res stream show STREAM — event count, version, first/last event timestamps
res event show ID — full event details (data, metadata, timestamps)
res event streams ID — all streams an event was published or linked to
res trace CORRELATION_ID — ASCII causation tree for a correlation ID
res search — search across all streams by type, time range, or stream name
res stats — total event count and unique event types; --stream for per-stream stats
res watch — live view of new events grouped by bounded context namespace

tomaszpatrzek and others added 30 commits

April 22, 2026 18:57


          Add ruby_event_store-cli gem skeleton

5dffc21

Scaffold for the new CLI contrib gem: gemspec, Gemfile, version,
main lib entry point, and executable bin/res.

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


          Add EventStoreResolver for CLI connection setup

38ea9c0

Auto-detects config/environment.rb in CWD. Supports explicit override
via EventStoreResolver.event_store= for non-standard setups.

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


          Add command routing with dry-cli registry

21dc696

Registers stream events as placeholder. res --help and
res stream events --help work.

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


          Implement stream events command

71ffcbd

res stream events STREAM_NAME reads and displays events in table or
json format with configurable limit.

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


          Add filtering options to stream events command

cb39f3e

Add --type, --after, --before, --from options to res stream events
for filtering by event class, time range, and pagination anchor.

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


          Show friendly error message for unknown event type

d431d16

Replace raw NameError with "Unknown event type: X" when --type
argument doesn't match a known constant.

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


          Add --follow / -f flag to res stream events

Polls for new events every second after initial read.
Exits cleanly on Ctrl+C (exit 0).

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


          Implement res stream show command

6f279dd

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


          Implement res event show command

bcb2524

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


          Implement res event streams command

e06f693

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


          Implement res trace command

bf1a93b

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


          Implement res search command with shared EventRenderer

a60ff22

Extract render logic from stream_events into EventRenderer module, reuse in search.

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


          Implement res stats command

75578a9

Uses event_store.read.count — no AR internals. Supports optional --stream flag.

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


          Show unique event types in res stats

f5a0d58

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


          Implement res watch command — live event view grouped by namespace

422ff74

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


          Add Makefile and clean up Gemfile

c84a981

Remove AR/Rails/SQLite deps — specs use in-memory client only.

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


          Add CI workflow for ruby_event_store-cli

b2b1a31

Tests on Ruby 3.2, 3.3, 3.4 — no database needed.

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


          Add mutant config

74870e7

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


          Add README

e433e98

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


          Improve command descriptions and add namespace subcommand hints

35a1e2f

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


          Add missing platforms to Gemfile.lock

2764a77

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


          Move event store resolution to bin/res, remove EventStoreResolver

eec0777

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


          Extract Base command class with event_store private method

3e3edb9

All commands inherit from Base instead of Dry::CLI::Command, removing
the repeated local variable assignment in every call method.

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


          Read event store from Rails.configuration instead of global constant

c54933a

Base#event_store reads Rails.configuration.event_store directly,
removing the CLI::EVENT_STORE constant assignment from bin/res.
Tests use stub_event_store helper backed by FakeConfiguration.

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


          Extract named methods in Watch#prepare

36a682a

Replace inline blocks with events_since, filter_by_namespaces,
and group_by_namespace to make each step explicit.

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


          Remove Follow command accidentally added during Watch rename

ba3b86a

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


          Extract watch loop into private method in Watch command

ab173a5

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


          Refactor Watch#render into named helper methods

627605e

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


          Guard against missing config/environment.rb with a friendly error

ceee4ee

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


          Add integration specs covering all CLI commands via Dry::CLI dispatch

f36ca3d

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

tomaszpatrzek and others added 9 commits

April 23, 2026 20:05


          Refactor StreamEvents#call into build_reader and tail methods

801c28b

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


          Extract print_event method in EventShow command

d18b3ea

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


          Extract streams_of private method in EventStreams command

f9b8305

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


          Extract ReadEvents class with self.of(specification, ...) for shared …

ae4e0e2

…filtering

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


          Refactor Stats#call into print_stats and print_event_types methods

e7b9cf9

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


          Use ReadEvents.of in tail, make limit optional

8c74b7c

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


          Refactor StreamShow#call into print_stream method

9b19e67

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


          Refactor Trace#call into events_for, print_causation_tree, root_event…

7bd166e

…s methods

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


          Rename test event classes to past tense convention

37fa1d1

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

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet