Add JSON schema for bloatware list and suggestions

aosp.json

@@ -126,7 +126,7 @@
         "id": "com.android.carrierdefaultapp",
         "label": "CarrierDefaultApp",
         "description": "This package is a generic solution that allows carriers to indicate when a device has run OOB (Out Of Balance). Android devices that are OOB need carrier mitigation protocols to allow select data through (like to notify users their data/balance is out, or allow them to buy more data through the carrier app).\nWill probably break that functionality if disabled, but is otherwise safe to disable (should only affect users that are out of data/balance?).",
-        "web" : [
+        "web": [
             "https://source.android.com/devices/tech/connect/oob-users"
         ],
         "removal": "caution"

schema/bloatware_list.json

@@ -0,0 +1,70 @@
+{
+    "$schema": "https://json-schema.org/draft/2020-12/schema",
+    "$id": "https://muntashirakon.github.io/android-debloat-list/bloatware_list.json",
+    "title": "Bloatware List",
+    "description": "Listing of Android bloatware",
+    "type": "array",
+    "items": {
+        "type": "object",
+        "properties": {
+            "id": {
+                "description": "Bloatware package name",
+                "type": "string"
+            },
+            "label": {
+                "description": "Bloatware package label",
+                "type": "string"
+            },
+            "dependencies": {
+                "description": "Packages that this bloatware depends on",
+                "type": "array",
+                "items": {
+                    "type": "string"
+                },
+                "minItems": 1,
+                "uniqueItems": true
+            },
+            "required_by": {
+                "description": "Packages that depend on this bloatware",
+                "type": "array",
+                "items": {
+                    "type": "string"
+                },
+                "minItems": 1,
+                "uniqueItems": true
+            },
+            "tags": {
+                "description": "Predefined tags",
+                "type": "array",
+                "items": {
+                    "type": "string"
+                },
+                "minItems": 1,
+                "uniqueItems": true
+            },
+            "description": {
+                "description": "Bloatware description",
+                "type": "string"
+            },
+            "web": {
+                "description": "Online references",
+                "type": "array",
+                "items": {
+                    "type": "string"
+                },
+                "minItems": 1,
+                "uniqueItems": true
+            },
+            "removal": {
+                "description": "Bloatware removal type (delete, replace, caution, unsafe)",
+                "type": "string"
+            },
+            "suggestions": {
+                "description": "Suggestion ID for listing alternatives to this bloatware",
+                "type": "string"
+            }
+        },
+        "required": [ "id", "label", "description", "removal" ]
+    },
+    "uniqueItems": true
+}

schema/suggestion_list.json

@@ -0,0 +1,34 @@
+{
+    "$schema": "https://json-schema.org/draft/2020-12/schema",
+    "$id": "https://muntashirakon.github.io/android-debloat-list/suggestion_list.json",
+    "title": "Suggestion List",
+    "description": "Listing of suggestions for Android bloatware",
+    "type": "array",
+    "items": {
+        "type": "object",
+        "properties": {
+            "id": {
+                "description": "Suggested package name",
+                "type": "string"
+            },
+            "label": {
+                "description": "Suggested package label",
+                "type": "string"
+            },
+            "reason": {
+                "description": "Reason for choosing this package if it violates some criteria",
+                "type": "string"
+            },
+            "source": {
+                "description": "Predefined list of app stores where this package might be located",
+                "type": "string"
+            },
+            "repo": {
+                "description": "Source code repository for this package",
+                "type": "string"
+            }
+        },
+        "required": [ "id", "label", "repo" ]
+    },
+    "uniqueItems": true
+}

scripts/lint.php

@@ -154,7 +154,7 @@ function validate_bloatware_item(array $item): int {
         fprintf($lint_writer, "{$item['id']}: Expected `warning` field to be a string, found: " . gettype($item['warning']) . "\n");
         ++$error_count;
     }
-    // `warning` is an optional string
+    // `suggestions` is an optional string
     if (isset($item['suggestions'])) {
         if (gettype($item['suggestions']) != 'string') {
             fprintf($lint_writer, "{$item['id']}: Expected `suggestions` field to be a string, found: " . gettype($item['suggestions']) . "\n");