Implemented operations helper commands for validation, locking, and status

internal/config/validate.go

@@ -152,24 +152,67 @@ func validateArchive(cfg *ArchiveConfig, scriptorium *ScriptoriumConfig) error {
 		}
 		seenDest[normalizedDest] = struct{}{}
 	}
+	locks, err := ValidateArchiveLockRules(cfg.Locks, scriptorium, "pipeline.archive.locks")
+	if err != nil {
+		return err
+	}
+	cfg.Locks = locks
+	return nil
+}
+
+// ValidateArchiveLockRules validates and normalizes source-based archive locks.
+func ValidateArchiveLockRules(locks []ArchiveLockRule, scriptorium *ScriptoriumConfig, label string) ([]ArchiveLockRule, error) {
 	seenLocks := map[string]struct{}{}
-	for i, item := range cfg.Locks {
-		prefix := fmt.Sprintf("pipeline.archive.locks[%d]", i)
+	out := make([]ArchiveLockRule, 0, len(locks))
+	if strings.TrimSpace(label) == "" {
+		label = "archive.locks"
+	}
+	for i, item := range locks {
+		prefix := fmt.Sprintf("%s[%d]", label, i)
 		source := strings.TrimSpace(item.Source)
 		if source == "" {
-			return fmt.Errorf("%s.source is required", prefix)
+			return nil, fmt.Errorf("%s.source is required", prefix)
 		}
 		if _, err := archiveSourceKnown(source, scriptorium); err != nil {
-			return fmt.Errorf("%s.source %q is unsupported: %w", prefix, item.Source, err)
+			return nil, fmt.Errorf("%s.source %q is unsupported: %w", prefix, item.Source, err)
 		}
 		if _, ok := seenLocks[source]; ok {
-			return fmt.Errorf("%s.source %q duplicates another archive lock source", prefix, source)
+			return nil, fmt.Errorf("%s.source %q duplicates another archive lock source", prefix, source)
 		}
 		seenLocks[source] = struct{}{}
-		cfg.Locks[i].Source = source
-		cfg.Locks[i].Reason = strings.TrimSpace(item.Reason)
+		out = append(out, ArchiveLockRule{
+			Source: source,
+			Reason: strings.TrimSpace(item.Reason),
+		})
 	}
-	return nil
+	return out, nil
+}
+
+// MergeArchiveLockRules returns the union of static and remote locks. Static
+// locks win when both sources contain the same lock.
+func MergeArchiveLockRules(staticLocks, remoteLocks []ArchiveLockRule) []ArchiveLockRule {
+	out := make([]ArchiveLockRule, 0, len(staticLocks)+len(remoteLocks))
+	seen := map[string]struct{}{}
+	for _, item := range staticLocks {
+		source := strings.TrimSpace(item.Source)
+		if source == "" {
+			continue
+		}
+		out = append(out, ArchiveLockRule{Source: source, Reason: strings.TrimSpace(item.Reason)})
+		seen[source] = struct{}{}
+	}
+	for _, item := range remoteLocks {
+		source := strings.TrimSpace(item.Source)
+		if source == "" {
+			continue
+		}
+		if _, ok := seen[source]; ok {
+			continue
+		}
+		out = append(out, ArchiveLockRule{Source: source, Reason: strings.TrimSpace(item.Reason)})
+		seen[source] = struct{}{}
+	}
+	return out
 }
 
 func archiveSourceKnown(source string, scriptorium *ScriptoriumConfig) (string, error) {