Clarify collection contracts and migration docs

2026-10-17 06:35:56 +00:00
parent 29f104fbc0
commit dfd8da843e
16 changed files with 236 additions and 102 deletions
--- a/observations.go
+++ b/observations.go
@@ -104,8 +104,9 @@ type ExecutionEvent struct {
 	RunID    string
 	Time     time.Time
 	PromptID string
-	// PromptVersion is the selected definition's descriptive label. Each event
-	// owns its pointer; nil means absent while a non-nil empty string is explicit.
+	// PromptVersion is the selected definition's optional descriptive label and
+	// never participates in prompt selection. Each event owns its pointer; nil
+	// means absent while a non-nil empty string is explicit.
 	PromptVersion      *string
 	ProfileID          string
 	BackendID          string