Document PromptKit request validation

integrations/ckprompt/validation.go

@@ -5,12 +5,12 @@ import (
 	promptkit "gitea.maximumdirect.net/eric/promptkit"
 )
 
-// ValidationRequest carries the configuration selection and concrete
-// PromptKit request to validate.
+// ValidationRequest carries the configuration selection and seed PromptKit
+// request populated by the standard validation command inputs.
 type ValidationRequest struct {
 	// Selection identifies the configuration sources used to load the engine.
 	Selection ckconfig.Selection
-	// Request is the seed request, or the request returned by a validation
-	// builder when one is configured.
+	// Request contains the prompt identity, scalar context, variables, and
+	// artifact references supplied to the command.
 	Request promptkit.RunRequest
 }