# Changelog

## Score

- CAI 51 → 55 (+4.0)
- Rubric changed (rubric-2026.10.5 → rubric-2026.11.2) — scores are not directly comparable.

## Lenses

- Code Health 65 → 66 (+0.6)
- Architecture 90 → 85 (-4.9)
- Maturity 55 → 81 (+26.6)
- Readiness 71 → 71 (+0.0)
- Security 35 → 34 (-0.5)
- Event Sourcing 100 → 100 (+0.0)
- Performance 79 → 79 (+0.0)

## Resolved (12)

- Ambiguous retrieval operations. `get` retrieves by ID, while `cas_read` retrieves by hash/integrity. While technically distinct, the naming convention `cas_read` vs `get` is inconsistent with standard CRUD patterns where `get` or `read` is the primary lookup. `cas_read` implies a Content-Addressable Storage specific operation, but `get` is generic. If the store is primarily CAS, `get` should likely be `get_by_id` or `cas_read` should be `get_by_hash` to be explicit.
- Checkable ADR rule enforced only by prose: ADR 0005: Lifecycle Topics (docs/adr/0005-lifecycle-topics.md)
- Duplicate functionality with different signatures (sync variants). Same issue as the async versions: `cas_insert_bytes_sync` is a subset of `cas_insert_sync`.
- Duplicate functionality with different signatures. `cas_insert` takes `impl AsRef<[u8]>` which covers `&[u8]`, `Vec<u8>`, `String`, etc. `cas_insert_bytes` takes `&[u8]` specifically. The latter is a strict subset of the former's capability, creating unnecessary API surface bloat.
- Duplicated block (5 lines × 3) (src/processor/action/serve.rs)
- Duplicated block (7 lines × 2) (src/main.rs)
- Duplicated block (9–10 lines × 3) (src/client/commands.rs)
- Inconsistent naming for sync/async pairs. While `cas_reader` vs `cas_reader_sync` is clear, the library also has `read` vs `read_sync` and `get` (no sync variant shown, implying it might be blocking or async via receiver). The existence of `_sync` suffixes for some CAS operations but not others (like `get`) suggests an inconsistent pattern for blocking vs non-blocking I/O.
- Medium vulnerability: RUSTSEC-2026-0346 (Cargo.lock)
- Medium vulnerability: RUSTSEC-2026-0367 (Cargo.lock)
- MethodTooLong: Store.read (src/store/mod.rs)
- Redundant error checking utilities. Both methods check for 'not found' conditions but have different names and likely different internal logic (one checks a specific type, the other checks IO errors). This forces users to know which specific error variant they are handling to pick the right helper.

## New (23)

- Classify ADR enforcement: 0006: Store builtins on a prepared, cloneable engine (docs/adr/0006-store-builtins-on-prepared-engine.md)
- Classify ADR enforcement: 0007: Engine tree (docs/adr/0007-engine-tree.md)
- Classify ADR enforcement: 0008: Follow: scan first, subscribe after, error on a live lag (docs/adr/0008-follow-scan-first.md)
- Classify ADR enforcement: 0009: Supervisors catch up after falling behind (docs/adr/0009-supervisors-catch-up.md)
- Classify ADR enforcement: ADR 0001: Topic Names and Hierarchical Queries (docs/adr/0001-hierarchical-topic-index.md)
- Classify ADR enforcement: ADR 0002: Disallow Numeric Prefix in Topic Names (docs/adr/0002-topic-no-numeric-prefix.md)
- Classify ADR enforcement: ADR 0003: Rename Processors to Service, Actor, Action (docs/adr/0003-rename-processors.md)
- Classify ADR enforcement: ADR 0004: Prefer Meta Over CAS for Structured Data (docs/adr/0004-actor-output-meta-over-cas.md)
- Classify ADR enforcement: ADR 0005: Lifecycle Topics (docs/adr/0005-lifecycle-topics.md)
- Critical CVE: [GHSA redacted] (Cargo.lock)
- Duplicated block (11 lines × 2) (src/client/commands.rs)
- Duplicated block (5 lines × 3) (src/processor/action/serve.rs)
- Duplicated block (7 lines × 2) (src/main.rs)
- Hotspot: src/api.rs (src/api.rs)
- Hotspot: src/processor/action/serve.rs (src/processor/action/serve.rs)
- Hotspot: src/processor/actor/serve.rs (src/processor/actor/serve.rs)
- Hotspot: src/processor/service/serve.rs (src/processor/service/serve.rs)
- Medium advisory (unsound): RUSTSEC-2026-0386 (Cargo.lock)
- Medium vulnerability: [GHSA redacted] (Cargo.lock)
- Medium vulnerability: RUSTSEC-2026-0385 (Cargo.lock)
- …and 3 more

## Changes since last survey

- 13 commits — 9 feature/other, 4 fixes

## By area

- src/processor — 5 commits
- (root) — 4 commits
- .github/workflows — 1 commit
- docs/src — 1 commit
- src/client — 1 commit
- src/main.rs — 1 commit

## Notable commits

- fix: fix: a service whose external exits non-zero stops with .fin.error
- fix: fix: a supervisor that falls behind live reads what it missed from the store (#172)
- fix: fix: read stored frames before subscribing, end a live lag with xs.lagged (ADR 0008) (#170)
- fix: fix: xs cat writes to a regular file or /dev/null (#173)
- change: chore: bump to 0.14.3-dev
- change: chore: bump to 0.15.1-dev
- change: chore: release 0.14.2
- change: chore: release 0.15.0
- change: docs: note that actor appends land when the closure returns (#167)
- change: feat: write an actor's appends and out frame as one batch (#168)
- change: refactor: use xs::Error for the crate's boxed error, not written out or private aliases (#171)
- change: test: fix clippy warnings in the integration tests (#174)
- change: test: the watch test fails at once with the service's error, and names inotify exhaustion as an environment limit (#175)
