# Changelog

## Score

- CAI 53 → 53 (-0.0)
- Rubric changed (rubric-2026.10.5 → rubric-2026.11.2) — scores are not directly comparable.

## Lenses

- Code Health 74 → 74 (+0.0)
- Architecture 98 → 98 (-0.5)
- Maturity 51 → 51 (+0.0)
- Readiness 35 → 35 (+0.0)
- Security 99 → 99 (+0.0)

## Resolved (6)

- Duplicate operations for cache bypass. Both `fresh()` and `refresh()` exist on `Builder` and `Cached`. In many ORMs, `fresh` implies a new instance/query, while `refresh` implies reloading existing state, but here they likely serve the same purpose of bypassing cache for the current operation.
- Duplicate operations for cache invalidation. Both `invalidate()` and `bust()` exist on `Builder` and `Cached` with identical signatures and likely identical intent (clearing cache).
- Inconsistent dispatching API. `Dispatcher` has separate methods for `command`, `query`, and `dispatch`. `dispatch` likely handles all, but the existence of specific methods suggests a lack of unified interface. Meanwhile, `Builder` uses `run()`, `get()`, `queue()`.
- Inconsistent execution semantics. `Command.run()` executes a command. `Query.run()` executes a query. However, `Cached.run()` and `Evented.run()` are wrappers that likely delegate to the underlying `Runnable`. The naming is consistent, but the underlying `Runnable` types (`Command` vs `Query`) have different return expectations (void vs data), which is not reflected in the method signature or documentation, leading to potential misuse.
- Inconsistent method availability across similar types. `Builder` has `toSql()`, but `Query` also has `toSql()`. However, `Cached` and `Evented` (which wrap `Runnable` like `Query`) do NOT have `toSql()`. This suggests `toSql()` is a feature of the query builder aspect, but it's not consistently exposed on all query-like wrappers.
- Inconsistent return types and naming for cache invalidation. `Builder` and `Cached` use `bust()` returning `self` (fluent), while the `Bust` concern defines `bust()` returning `bool`. This creates ambiguity about whether the operation succeeded or allows chaining.
