bwaidelich/dcb-eventstore

This system is a PHP-based event sourcing library that provides an in-memory implementation of an event store. It enables the storage and retrieval of domain events with support for conditional appends, sequence-based ordering, and flexible querying by type, tag, or metadata. The codebase includes comprehensive test coverage and strict code quality tooling to ensure reliability.

4 changes.

This period focused on establishing the project's foundational infrastructure, including code style, static analysis, and testing tooling. The core domain logic was introduced through an EventStore interface and an in-memory implementation, supported by comprehensive integration tests to ensure reliability.

9 changes.

This period focused on implementing the core domain model for an event store, introducing classes for events, queries, and sequencing. The work included building the necessary infrastructure for event storage and retrieval, supported by comprehensive unit tests for all new components.

Added the core EventStore interface defining read and append operations, including support for conditional appends that validate state before writing. The in-memory implementation provides a testing/debugging tool that enforces these conditions, throwing ConditionalAppendFailed when constraints are violated. Read operations now support filtering by sequence position, limiting results, and reversing order via ReadOptions.

src · high confidence

Added src/Query/Query.php and src/Query/QueryItem.php, introducing a new Query class that supports JSON serialization, merging of query constraints, and event matching. The Query class implements IteratorAggregate and JsonSerializable, allowing queries to be iterated and serialized. The QueryItem class provides a builder for creating query items with event types, tags, and a flag for last event filtering. The merge logic combines compatible query items, and the matchesEvent method checks if an event satisfies the query constraints.

src/Query · high confidence

The codebase now includes new value objects for event sequencing: \SequencePosition\ represents a global sequence number with methods to navigate previous and next positions, and \SequencedEvent\ wraps an \Event\ with its position and recording timestamp. The \SequencedEvents\ class provides an iterator over these sequenced events, ensuring uniqueness by position and offering a \first()\ accessor.

src/SequencedEvent · high confidence

Added new classes in the Event namespace (Event, EventData, EventMetadata, EventType, EventTypes, Events, Tag, Tags) that define the structure and behavior of events in the event store. These classes provide type-safe handling of event data, metadata, and tags, with support for JSON serialization and stringable representations.

src/Event · high confidence

A new AppendCondition class has been introduced to manage conditions for the EventStore::append() method. This class encapsulates a Query for failure conditions and an optional SequencePosition for ordering, providing a static create() factory method that accepts either a Query and an integer or SequencePosition for the 'after' parameter.

src/AppendCondition · medium confidence

Added configuration files for code style enforcement (\.editorconfig\, \.php-cs-fixer.dist.php\), static analysis (\phpstan.neon.dist\), and testing (\phpunit.xml\). A \check-coverage.php\ script was added to enforce 100% code coverage, and \.gitattributes\ was created to exclude development and configuration files from exports.

(repo-wide) · high confidence

Added integration tests for the in-memory event store; Added unit tests for AppendCondition and InMemoryEventStore; Added unit tests for Event domain classes; Added unit tests for Query and QueryItem classes; Added unit tests for SequencedEvent components; Added unit tests for exception handling, read options, and README code blocks.

The package now requires PHP 8.3 or higher and includes dependencies for PSR Clock, webmozart/assert (versions ^1.11.0 or ^2.0.0), PHPStan ^2, PHP CS Fixer ^3.88, and PHPUnit ^11. This establishes the foundational build configuration and tooling for the project.

(dependencies) · high confidence

Written by watchdog.canine.dev from the codebase's own history, inside the signed delivery this page is composed from.

• CAI 63 → 66 (+3.7)
• Rubric changed (rubric-2026.08.19 → rubric-2026.09.15) — scores are not directly comparable.

• Code Health 98 → 99 (+1.0)
• Architecture 69 → 69 (+0.0)
• Maturity 58 → 59 (+1.2)
• Readiness 68 → 63 (-4.3)
• Security 61 → 97 (+36.2)

• Coverage not included — suite not readable by the collector
• Dependency hygiene not measured — dependency manifest found but not parsed for hygiene
• Duplicated block (8 lines × 2) (src/Query/QueryItem.php)
• High: security finding (details withheld)
• High: security finding (details withheld)
• High: security finding (details withheld)
• High: security finding (details withheld)
• High: security finding (details withheld)
• High: security finding (details withheld)
• High: security finding (details withheld)
• High: security finding (details withheld)
• High: security finding (details withheld)
• No exposed public API
• Small-team knowledge concentration
• Test reliability not included
• The Usage section is clipped mid-sentence, so the Create Event Store instance and higher-level API sections are not yet visible. (README.md)

• Dependency hygiene PARTLY measured — Composer dependencies read, no committed lock to grade for currency
• Documentation: no usage examples (README.md)
• Duplicated block (10 lines × 2) (src/Query/QueryItem.php)
• High: security finding (details withheld)
• High: security finding (details withheld)
• High: security finding (details withheld)
• High: security finding (details withheld)
• High: security finding (details withheld)
• High: security finding (details withheld)
• High: security finding (details withheld)
• High: security finding (details withheld)
• High: security finding (details withheld)
• Inverted test pyramid
• Medium: security finding (details withheld)
• Medium: security finding (details withheld)
• No assertions: test_consistency (tests/Integration/EventStoreConcurrencyTestBase.php)
• No dependency advisory monitoring
• bus factor 1 — one contributor carries this repository

Written by watchdog.canine.dev from the codebase's own history, inside the signed delivery this page is composed from.

bwaidelich/dcb-eventstore was measured the same way every project in this corpus was: the same rubric, at a pinned commit, with the result published in full. Point a surveyor at a repository you know and see whether you agree with it.