You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copy file name to clipboardExpand all lines: agent-docs/changelog.md
+10-10Lines changed: 10 additions & 10 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -18,7 +18,7 @@ Each entry includes:
18
18
19
19
---
20
20
21
-
## 2025-01-25
21
+
## 2025-09-19
22
22
23
23
### Agent Documentation Structure Scaffolding
24
24
**Change**: Created comprehensive agent documentation structure following scaffolding framework
@@ -27,7 +27,7 @@ Each entry includes:
27
27
**Impact**: Agents now have proper guidance for working ON AshEvents development vs using AshEvents as dependency
28
28
**Key Insights**: Clear separation between consumer docs (usage-rules.md) and developer docs (agent-docs/) significantly improves development workflow
29
29
30
-
### Documentation Focus Clarification
30
+
### Documentation Focus Clarification
31
31
**Change**: Clarified that usage-rules.md is consumer documentation, not internal development guidance
32
32
**Context**: Previous AGENTS.md incorrectly referenced usage-rules.md for internal development tasks
33
33
**Files**: `agent-docs/index.md`, updated understanding of documentation structure
@@ -36,20 +36,20 @@ Each entry includes:
36
36
37
37
---
38
38
39
-
## 2025-01-25 (Continued)
39
+
## 2025-09-19 (Continued)
40
40
41
41
### Changed Attributes Tracking Implementation
42
42
**Change**: Added comprehensive changed attributes tracking and replay functionality to AshEvents core
43
43
**Context**: Event replay was incomplete for resources with business logic that modified attributes beyond the original input parameters. Default values, auto-generated attributes (slugs, UUIDs, computed fields), and attributes modified by Ash changes/extensions were not being captured in events, causing incomplete state reconstruction during replay. This is a critical gap for real-world event sourcing applications where business logic transforms input data.
44
-
**Files**:
44
+
**Files**:
45
45
-`lib/event_log/transformers/add_attributes.ex` - Added `changed_attributes` field to event resources
-`lib/events/changes/apply_changed_attributes.ex` - New change module for applying changed attributes during replay
48
48
-`lib/events/action_wrapper_helpers.ex` - Modified to capture changed attributes during event creation
49
49
-`lib/event_log/replay.ex` - Enhanced to pass changed attributes context during replay
50
50
-`test/ash_events/changed_attributes_test.exs` - Comprehensive test coverage
51
51
**Impact**: AshEvents now supports complete state reconstruction for complex business logic scenarios. This enables proper event sourcing for applications with extensive attribute transformations, default value applications, and computed field generation. The two-strategy approach (`:force_change` vs `:as_arguments`) provides flexibility for different replay requirements.
52
-
**Key Insights**:
52
+
**Key Insights**:
53
53
- Event sourcing requires capturing not just input parameters but also all business logic transformations
54
54
- Separating original input (`event.data`) from business logic changes (`event.changed_attributes`) provides clear audit trails
55
55
- Context propagation in Ash action pipelines requires careful timing - changes must have context available from the start
@@ -126,7 +126,7 @@ Each entry includes:
126
126
- Consistent actor attribution handling
127
127
- Safe type casting and data serialization
128
128
129
-
### Replay Functionality Architecture
129
+
### Replay Functionality Architecture
130
130
**Current State**: Centralized replay in `lib/event_log/replay.ex` with sophisticated change handling
131
131
**Key Patterns**:
132
132
- Replay change wrapper for handling complex change modules
@@ -147,7 +147,7 @@ Each entry includes:
147
147
**Key Patterns**:
148
148
- DSL definitions in main extension files
149
149
- Implementation logic in transformers
150
-
- Validation in verifiers
150
+
- Validation in verifiers
151
151
- Generated documentation from DSL definitions
152
152
153
153
---
@@ -185,6 +185,6 @@ Each entry includes:
185
185
186
186
---
187
187
188
-
**Last Updated**: 2025-01-25
189
-
**Focus**: Internal development context and decisions
190
-
**Next Review**: After next major internal development milestone
188
+
**Last Updated**: 2025-01-25
189
+
**Focus**: Internal development context and decisions
190
+
**Next Review**: After next major internal development milestone
0 commit comments