package governance import ( "errors" "strings" "time" "unicode" ) type ScopeTargetType string const ( ScopeTargetDirectory ScopeTargetType = "directory" ScopeTargetItem ScopeTargetType = "item" ) type ScopeRuleMutation struct { TargetType ScopeTargetType ConnectionID string DirectoryPath string SourceItemID string Visibility Visibility OperatorRef string Reason string Clear bool Now time.Time } type ScopeRule struct { TargetType ScopeTargetType `json:"target_type"` ConnectionID string `json:"connection_id,omitempty"` DirectoryPath string `json:"directory_path,omitempty"` SourceItemID string `json:"source_item_id,omitempty"` Visibility Visibility `json:"visibility"` UpdatedBy string `json:"updated_by"` Reason string `json:"reason"` UpdatedAt time.Time `json:"updated_at"` } func (request ScopeRuleMutation) Validate() error { if request.TargetType != ScopeTargetDirectory && request.TargetType != ScopeTargetItem { return errors.New("scope target must be directory or item") } if request.TargetType == ScopeTargetDirectory { if strings.TrimSpace(request.ConnectionID) == "" || request.SourceItemID != "" || !validScopePath(request.DirectoryPath) { return errors.New("directory scope target is invalid") } } else if strings.TrimSpace(request.SourceItemID) == "" || request.ConnectionID != "" || request.DirectoryPath != "" { return errors.New("item scope target is invalid") } if !request.Clear && request.Visibility != VisibilityInternal && request.Visibility != VisibilityExternal { return errors.New("visibility must be internal or external") } if request.Clear && request.Visibility != "" { return errors.New("clear scope must not include visibility") } operator := strings.TrimSpace(request.OperatorRef) reason := strings.TrimSpace(request.Reason) if operator == "" || len(operator) > 128 || reason == "" || len(reason) > 500 || request.Now.IsZero() { return errors.New("operator, reason, and time are required") } return nil } func validScopePath(value string) bool { if len(value) > 2048 || strings.HasPrefix(value, "/") || strings.Contains(value, "\\") { return false } for _, part := range strings.Split(value, "/") { if part == "." || part == ".." { return false } } for _, value := range value { if unicode.IsControl(value) { return false } } return true }