saygoweb / anorm / 25251759671

97%

Build Type

push

github

Committed by web-flow

Commit Message

Read/write lifecycle hooks for change detection (#48)

* Add CLAUDE.md and Serena project config/memories

Onboards AI agents (Claude Code, Serena) with project layout, conventions,
commands, and done-criteria so future sessions can ramp up without
re-deriving context. Memories cover the in-flight 2026-05 change-detection
work as well as general project conventions.

* feat(lifecycle): add ChangeListenerInterface and listener registry

Bootstraps the new Anorm\Lifecycle namespace with the listener interface,
re-entrancy exception type, and static set/get on DataMapper. No call sites
yet — purely additive.

* fix(lifecycle): reset insideListener flag and drop unused import

Address code-review feedback on Task 1: setChangeListener(null) now
also resets the re-entrancy guard so tearDown is exhaustive ahead of
Task 6 landing the actual write-path guard. Drop the pre-staged
ChangeListenerInterface use from the test file — Task 6 will reintroduce
it when first needed.

* test(lifecycle): add fixture schema, model, and value-object classes

LifecycleModel exposes id, name, email, dtu, payload — enough to cover
infrastructureProperties exclusion (dtu) and partial-load (email)
scenarios. Three value-object classes cover the three object-equality
paths: LifecycleMoney (equals), LifecycleSameMoney (isSame),
LifecycleBagMoney (loose ==).

* style(lifecycle): import TestEnvironment instead of inline FQCN

Match the convention of every other test file in the suite and the
already-imported LifecycleModel / RecordingListener in this same file.
No behavioural change.

* feat(lifecycle): add Model::$_lastSnapshot property

Underscore-prefixed so it stays out of the column map. Defaults to null.
Will be populated by DataMapper::readArray when a listener is registered.

Also fixes DataMapper::autoMap to properly skip underscore-prefixed
properties per the existing convention used in write() and readArray().

* refactor(autoMap): drop dead unset and noisy comment

The un... (continued)

Coverage Stats

61 of 65 new or added lines in 1 file covered. (93.85%)

2 existing lines in 1 file now uncovered.

1692 of 2001 relevant lines covered (84.56%)

17.05 hits per line