feat(preprod): Add App Clip artifact support to size checks (#108676)

Add backend App Clip artifact support across preprod size checks.

This wires App Clip through the backend size-analysis and VCS check
pipeline:
- extend `PreprodArtifactSizeMetrics.MetricsArtifactType` with
`APP_CLIP_ARTIFACT`
- add status check rule type mapping/filtering for app clips
- render App Clip in status-check templates following existing
Watch-style labeling conventions
- update status-check copy to component-centric wording
- add/adjust tests for model parsing, task ingestion, status-check
filtering, templates, and webhook payload expectations

Stack context:
- base/frontend dependency: PR #108675

Merge/deploy ordering for EME-811:
1) Frontend first (PR #108675)
2) Backend (this PR)
3) Launchpad emitter changes last

<img width="764" height="462" alt="Screenshot 2026-02-19 at 16 11 02"
src="https://github.com/user-attachments/assets/cc5cd77e-2ed7-40ff-ac26-4b524f5216fe"
/>

Refs EME-811

Author: cameroncooke

src/sentry/preprod/models.py

@@ -522,13 +522,16 @@ class MetricsArtifactType(IntEnum):
         """An embedded watch artifact."""
         ANDROID_DYNAMIC_FEATURE = 2
         """An embedded Android dynamic feature artifact."""
+        APP_CLIP_ARTIFACT = 3
+        """An embedded App Clip artifact."""
 
         @classmethod
         def as_choices(cls) -> tuple[tuple[int, str], ...]:
             return (
                 (cls.MAIN_ARTIFACT, "main_artifact"),
                 (cls.WATCH_ARTIFACT, "watch_artifact"),
                 (cls.ANDROID_DYNAMIC_FEATURE, "android_dynamic_feature_artifact"),
+                (cls.APP_CLIP_ARTIFACT, "app_clip_artifact"),
             )
 
     class SizeAnalysisState(IntEnum):

src/sentry/preprod/vcs/status_checks/size/tasks.py

@@ -89,6 +89,7 @@
     RuleArtifactType.MAIN_ARTIFACT: PreprodArtifactSizeMetrics.MetricsArtifactType.MAIN_ARTIFACT,
     RuleArtifactType.WATCH_ARTIFACT: PreprodArtifactSizeMetrics.MetricsArtifactType.WATCH_ARTIFACT,
     RuleArtifactType.ANDROID_DYNAMIC_FEATURE_ARTIFACT: PreprodArtifactSizeMetrics.MetricsArtifactType.ANDROID_DYNAMIC_FEATURE,
+    RuleArtifactType.APP_CLIP_ARTIFACT: PreprodArtifactSizeMetrics.MetricsArtifactType.APP_CLIP_ARTIFACT,
 }
 
 

src/sentry/preprod/vcs/status_checks/size/templates.py

@@ -85,17 +85,29 @@ def format_status_check_messages(
     parts = []
     if analyzed_count > 0 and not triggered_rules:
         parts.append(
-            ngettext("%(count)d app analyzed", "%(count)d apps analyzed", analyzed_count)
+            ngettext(
+                "%(count)d component analyzed",
+                "%(count)d components analyzed",
+                analyzed_count,
+            )
             % {"count": analyzed_count}
         )
     if processing_count > 0:
         parts.append(
-            ngettext("%(count)d app processing", "%(count)d apps processing", processing_count)
+            ngettext(
+                "%(count)d component processing",
+                "%(count)d components processing",
+                processing_count,
+            )
             % {"count": processing_count}
         )
     if errored_count > 0:
         parts.append(
-            ngettext("%(count)d app errored", "%(count)d apps errored", errored_count)
+            ngettext(
+                "%(count)d component errored",
+                "%(count)d components errored",
+                errored_count,
+            )
             % {"count": errored_count}
         )
 
@@ -478,6 +490,8 @@ def _get_size_metric_type_display_name(
             return "Watch"
         case PreprodArtifactSizeMetrics.MetricsArtifactType.ANDROID_DYNAMIC_FEATURE:
             return "Dynamic Feature"
+        case PreprodArtifactSizeMetrics.MetricsArtifactType.APP_CLIP_ARTIFACT:
+            return "App Clip"
         case _:
             return None
 
@@ -495,6 +509,8 @@ def _get_triggered_metric_type_display_name(
             if identifier:
                 return f"Dynamic Feature ({identifier})"
             return "Dynamic Feature"
+        case PreprodArtifactSizeMetrics.MetricsArtifactType.APP_CLIP_ARTIFACT:
+            return "App Clip"
         case _:
             return ""
 

src/sentry/preprod/vcs/status_checks/size/types.py

@@ -8,6 +8,7 @@ class RuleArtifactType(StrEnum):
     MAIN_ARTIFACT = "main_artifact"
     WATCH_ARTIFACT = "watch_artifact"
     ANDROID_DYNAMIC_FEATURE_ARTIFACT = "android_dynamic_feature_artifact"
+    APP_CLIP_ARTIFACT = "app_clip_artifact"
     ALL_ARTIFACTS = "all_artifacts"
 
     @classmethod

tests/sentry/preprod/test_models_size_metrics.py

@@ -26,10 +26,15 @@ def test_get_size_metrics_filtering(self):
             metrics_type=PreprodArtifactSizeMetrics.MetricsArtifactType.ANDROID_DYNAMIC_FEATURE,
             identifier="test_feature",
         )
+        app_clip_metrics = self.create_preprod_artifact_size_metrics(
+            artifact,
+            metrics_type=PreprodArtifactSizeMetrics.MetricsArtifactType.APP_CLIP_ARTIFACT,
+            identifier="test_app_clip",
+        )
 
         # Test getting all metrics (no filters)
         all_metrics = artifact.get_size_metrics()
-        assert all_metrics.count() == 3
+        assert all_metrics.count() == 4
 
         # Test filtering by metrics type
         main_only = artifact.get_size_metrics(
@@ -65,6 +70,15 @@ def test_get_size_metrics_filtering(self):
         assert feature_typed_first is not None
         assert feature_typed_first.id == feature_metrics.id
 
+        app_clip_only = artifact.get_size_metrics(
+            metrics_artifact_type=PreprodArtifactSizeMetrics.MetricsArtifactType.APP_CLIP_ARTIFACT,
+            identifier="test_app_clip",
+        )
+        assert app_clip_only.count() == 1
+        app_clip_first = app_clip_only.first()
+        assert app_clip_first is not None
+        assert app_clip_first.id == app_clip_metrics.id
+
         # Test no matches
         no_matches = artifact.get_size_metrics(identifier="nonexistent")
         assert no_matches.count() == 0
@@ -82,6 +96,11 @@ def test_get_size_metrics_for_artifacts_bulk(self):
             artifact1,
             metrics_type=PreprodArtifactSizeMetrics.MetricsArtifactType.WATCH_ARTIFACT,
         )
+        artifact1_app_clip = self.create_preprod_artifact_size_metrics(
+            artifact1,
+            metrics_type=PreprodArtifactSizeMetrics.MetricsArtifactType.APP_CLIP_ARTIFACT,
+            identifier="clip.one",
+        )
         artifact2_main = self.create_preprod_artifact_size_metrics(
             artifact2,
             metrics_type=PreprodArtifactSizeMetrics.MetricsArtifactType.MAIN_ARTIFACT,
@@ -92,7 +111,7 @@ def test_get_size_metrics_for_artifacts_bulk(self):
 
         assert artifact1.id in results
         assert artifact2.id in results
-        assert results[artifact1.id].count() == 2  # main + watch
+        assert results[artifact1.id].count() == 3  # main + watch + app clip
         assert results[artifact2.id].count() == 1  # main only
 
         # Test bulk retrieval with type filter (should get only main metrics)
@@ -122,6 +141,18 @@ def test_get_size_metrics_for_artifacts_bulk(self):
         assert artifact1_watch_first is not None
         assert artifact1_watch_first.id == artifact1_watch.id
 
+        app_clip_results = PreprodArtifact.get_size_metrics_for_artifacts(
+            [artifact1, artifact2],
+            metrics_artifact_type=PreprodArtifactSizeMetrics.MetricsArtifactType.APP_CLIP_ARTIFACT,
+            identifier="clip.one",
+        )
+
+        assert app_clip_results[artifact1.id].count() == 1
+        assert app_clip_results[artifact2.id].count() == 0
+        artifact1_app_clip_first = app_clip_results[artifact1.id].first()
+        assert artifact1_app_clip_first is not None
+        assert artifact1_app_clip_first.id == artifact1_app_clip.id
+
         # Test with empty list
         empty_results = PreprodArtifact.get_size_metrics_for_artifacts([])
         assert empty_results == {}
@@ -144,6 +175,11 @@ def test_get_size_metrics_ignores_other_artifacts(self):
             metrics_type=PreprodArtifactSizeMetrics.MetricsArtifactType.ANDROID_DYNAMIC_FEATURE,
             identifier="feature_a",
         )
+        artifact1_app_clip = self.create_preprod_artifact_size_metrics(
+            artifact1,
+            metrics_type=PreprodArtifactSizeMetrics.MetricsArtifactType.APP_CLIP_ARTIFACT,
+            identifier="clip_a",
+        )
 
         artifact2_main = self.create_preprod_artifact_size_metrics(
             artifact2,
@@ -158,22 +194,37 @@ def test_get_size_metrics_ignores_other_artifacts(self):
             metrics_type=PreprodArtifactSizeMetrics.MetricsArtifactType.ANDROID_DYNAMIC_FEATURE,
             identifier="feature_a",  # Same identifier as artifact1 but different artifact
         )
+        artifact2_app_clip = self.create_preprod_artifact_size_metrics(
+            artifact2,
+            metrics_type=PreprodArtifactSizeMetrics.MetricsArtifactType.APP_CLIP_ARTIFACT,
+            identifier="clip_a",
+        )
 
         # Test artifact1's metrics - should only get artifact1 metrics, not artifact2
         artifact1_metrics = artifact1.get_size_metrics()
-        assert artifact1_metrics.count() == 3
+        assert artifact1_metrics.count() == 4
 
         artifact1_ids = {m.id for m in artifact1_metrics}
-        expected_artifact1_ids = {artifact1_main.id, artifact1_watch.id, artifact1_feature.id}
+        expected_artifact1_ids = {
+            artifact1_main.id,
+            artifact1_watch.id,
+            artifact1_feature.id,
+            artifact1_app_clip.id,
+        }
         assert artifact1_ids == expected_artifact1_ids
 
         # Ensure none of artifact2's metrics are included
-        artifact2_ids = {artifact2_main.id, artifact2_watch.id, artifact2_feature.id}
+        artifact2_ids = {
+            artifact2_main.id,
+            artifact2_watch.id,
+            artifact2_feature.id,
+            artifact2_app_clip.id,
+        }
         assert artifact1_ids.isdisjoint(artifact2_ids)
 
         # Test artifact2's metrics - should only get artifact2 metrics, not artifact1
         artifact2_metrics = artifact2.get_size_metrics()
-        assert artifact2_metrics.count() == 3
+        assert artifact2_metrics.count() == 4
 
         artifact2_result_ids = {m.id for m in artifact2_metrics}
         assert artifact2_result_ids == artifact2_ids

tests/sentry/preprod/test_tasks.py

@@ -911,6 +911,37 @@ def test_assemble_preprod_artifact_size_analysis_multiple_components(self) -> No
         assert watch_metrics.max_download_size == 2000
         assert watch_metrics.max_install_size == 4000
 
+    def test_assemble_preprod_artifact_size_analysis_app_clip_component(self) -> None:
+        status, details = self._run_task_and_verify_status(
+            b'{"analysis_duration": 2.5, "download_size": 5000, "install_size": 10000, "treemap": null, "analysis_version": "1.0", "app_components": [{"component_type": 0, "name": "Main App", "app_id": "com.example.app", "path": "/", "download_size": 3000, "install_size": 6000}, {"component_type": 3, "name": "App Clip", "app_id": "com.example.app.clip", "path": "/AppClips/AppClip.app", "download_size": 2000, "install_size": 4000}]}'
+        )
+
+        assert status == ChunkFileState.OK
+        assert details is None
+
+        all_size_metrics = PreprodArtifactSizeMetrics.objects.filter(
+            preprod_artifact=self.preprod_artifact
+        ).order_by("metrics_artifact_type")
+        assert len(all_size_metrics) == 2
+
+        main_metrics = all_size_metrics[0]
+        assert (
+            main_metrics.metrics_artifact_type
+            == PreprodArtifactSizeMetrics.MetricsArtifactType.MAIN_ARTIFACT
+        )
+        assert main_metrics.identifier is None
+        assert main_metrics.max_download_size == 3000
+        assert main_metrics.max_install_size == 6000
+
+        app_clip_metrics = all_size_metrics[1]
+        assert (
+            app_clip_metrics.metrics_artifact_type
+            == PreprodArtifactSizeMetrics.MetricsArtifactType.APP_CLIP_ARTIFACT
+        )
+        assert app_clip_metrics.identifier == "com.example.app.clip"
+        assert app_clip_metrics.max_download_size == 2000
+        assert app_clip_metrics.max_install_size == 4000
+
     def test_assemble_preprod_artifact_size_analysis_removes_stale_metrics(self) -> None:
         status, details = self._run_task_and_verify_status(
             b'{"analysis_duration": 2.5, "download_size": 5000, "install_size": 10000, "treemap": null, "analysis_version": "1.0", "app_components": [{"component_type": 0, "name": "Main App", "app_id": "com.example.app", "path": "/", "download_size": 3000, "install_size": 6000}, {"component_type": 1, "name": "Watch App", "app_id": "com.example.app.watchkitapp", "path": "/Watch", "download_size": 2000, "install_size": 4000}]}'

tests/sentry/preprod/vcs/status_checks/size/test_metric_selection_helpers.py

@@ -50,6 +50,10 @@ def test_get_candidate_metrics_for_rule_main_artifact(self) -> None:
             PreprodArtifactSizeMetrics.MetricsArtifactType.ANDROID_DYNAMIC_FEATURE,
             identifier="feature.alpha",
         )
+        self._create_metric(
+            PreprodArtifactSizeMetrics.MetricsArtifactType.APP_CLIP_ARTIFACT,
+            identifier="com.example.app.clip",
+        )
 
         rule = StatusCheckRule(
             id="rule-main",
@@ -74,6 +78,10 @@ def test_get_candidate_metrics_for_rule_all_artifacts_sorted(self) -> None:
             PreprodArtifactSizeMetrics.MetricsArtifactType.ANDROID_DYNAMIC_FEATURE,
             identifier="dynamic.a",
         )
+        app_clip_a = self._create_metric(
+            PreprodArtifactSizeMetrics.MetricsArtifactType.APP_CLIP_ARTIFACT,
+            identifier="clip.a",
+        )
         main = self._create_metric(PreprodArtifactSizeMetrics.MetricsArtifactType.MAIN_ARTIFACT)
         watch_a = self._create_metric(
             PreprodArtifactSizeMetrics.MetricsArtifactType.WATCH_ARTIFACT,
@@ -88,9 +96,11 @@ def test_get_candidate_metrics_for_rule_all_artifacts_sorted(self) -> None:
             artifact_type=RuleArtifactType.ALL_ARTIFACTS,
         )
 
-        candidates = _get_candidate_metrics_for_rule(rule, [watch_b, dynamic_a, main, watch_a])
+        candidates = _get_candidate_metrics_for_rule(
+            rule, [watch_b, dynamic_a, app_clip_a, main, watch_a]
+        )
 
-        assert candidates == [main, watch_a, watch_b, dynamic_a]
+        assert candidates == [main, watch_a, watch_b, dynamic_a, app_clip_a]
 
     def test_get_matching_base_metric_matches_type_and_identifier(self) -> None:
         base_main = self._create_metric(
@@ -115,6 +125,27 @@ def test_get_matching_base_metric_matches_type_and_identifier(self) -> None:
 
         assert matched == base_watch
 
+    def test_get_candidate_metrics_for_rule_app_clip_artifact(self) -> None:
+        app_clip = self._create_metric(
+            PreprodArtifactSizeMetrics.MetricsArtifactType.APP_CLIP_ARTIFACT,
+            identifier="com.example.app.clip",
+        )
+        self._create_metric(PreprodArtifactSizeMetrics.MetricsArtifactType.MAIN_ARTIFACT)
+
+        rule = StatusCheckRule(
+            id="rule-app-clip",
+            metric="install_size",
+            measurement="absolute",
+            value=1000,
+            artifact_type=RuleArtifactType.APP_CLIP_ARTIFACT,
+        )
+
+        candidates = _get_candidate_metrics_for_rule(
+            rule, list(PreprodArtifactSizeMetrics.objects.filter(preprod_artifact=self.artifact))
+        )
+
+        assert candidates == [app_clip]
+
     def test_get_matching_base_metric_returns_none_when_identifier_differs(self) -> None:
         base_watch = self._create_metric(
             PreprodArtifactSizeMetrics.MetricsArtifactType.WATCH_ARTIFACT,