Initial commit of Descrybe v2 without local scratch artifacts.

Drop one-shot tmp/axe scripts and agent i18n scratch so the Gitea tree is deployable.

apps/api/internal/processing/errors.go

@@ -0,0 +1,41 @@
+package processing
+
+import "errors"
+
+// Sentinel errors returned by the processing pipeline. Handlers should use
+// errors.Is and expose only these (or wrapped forms) to clients.
+var (
+	ErrRateLimited         = errors.New("rate limit: too many processing jobs started; retry shortly")
+	ErrRawIDsRequired      = errors.New("raw_product_ids required")
+	ErrTooManyProducts     = errors.New("too many products")
+	ErrNoMatchingProducts  = errors.New("no matching products for company")
+	ErrRawProductsNotFound = errors.New("one or more raw products not found for this company")
+	ErrJobNotCancellable   = errors.New("job not cancellable")
+	ErrJobStillActive      = errors.New("job still active")
+	ErrJobNotRetryable     = errors.New("job not retryable")
+	// Orphan cleanup confirm gates (fail-closed).
+	ErrOrphanCleanupEmpty       = errors.New("no orphans to delete")
+	ErrOrphanCleanupA1Protected = errors.New("refusing orphan cleanup that touches A1 cohort")
+)
+
+// ClientError reports whether err is a known client-facing processing error
+// and returns a stable public message (preserves wrap details when present).
+func ClientError(err error) (msg string, ok bool) {
+	switch {
+	case err == nil:
+		return "", false
+	case errors.Is(err, ErrRateLimited),
+		errors.Is(err, ErrRawIDsRequired),
+		errors.Is(err, ErrTooManyProducts),
+		errors.Is(err, ErrNoMatchingProducts),
+		errors.Is(err, ErrRawProductsNotFound),
+		errors.Is(err, ErrJobNotCancellable),
+		errors.Is(err, ErrJobStillActive),
+		errors.Is(err, ErrJobNotRetryable),
+		errors.Is(err, ErrOrphanCleanupEmpty),
+		errors.Is(err, ErrOrphanCleanupA1Protected):
+		return err.Error(), true
+	default:
+		return "", false
+	}
+}