Apply overrides from git commits

Author: abraham

config.json

@@ -2,5 +2,7 @@
   "mastodonDocsCommit": "f760ffcdf3371a641ba5d731dd33348fc6eb4fe6",
   "mastodonVersion": "4.4.0",
   "minimumMastodonVersion": "4.2.0",
-  "blockedFiles": ["methods/notifications_alpha.md"]
+  "blockedFiles": ["methods/notifications_alpha.md"],
+  "overridesRepository": "https://github.com/abraham/documentation",
+  "overrideCommits": ["b1d8f95b506e2d734876ef47ec0f4e1feb4f5618"]
 }

dist/schema.json

@@ -35184,6 +35184,28 @@
               "null"
             ],
             "properties": {
+              "small": {
+                "description": "Details about the small preview version of the attachment.",
+                "oneOf": [
+                  {
+                    "$ref": "#/components/schemas/MetaDetails"
+                  },
+                  {
+                    "type": "null"
+                  }
+                ]
+              },
+              "original": {
+                "description": "Details about the original version of the attachment.",
+                "oneOf": [
+                  {
+                    "$ref": "#/components/schemas/MetaDetails"
+                  },
+                  {
+                    "type": "null"
+                  }
+                ]
+              },
               "focus": {
                 "description": "Coordinates that may be used for smart thumbnail cropping -- see [Focal points for cropped media thumbnails]({{< relref \"api/guidelines#focal-points\" >}}) for more.",
                 "type": [
@@ -35241,6 +35263,15 @@
           "description": "Official Mastodon API documentation"
         }
       },
+      "MetaDetails": {
+        "type": "object",
+        "description": "Additional entity definition for MetaDetails",
+        "properties": {},
+        "externalDocs": {
+          "url": "https://docs.joinmastodon.org/entities/MediaAttachment/#attributes",
+          "description": "Official Mastodon API documentation"
+        }
+      },
       "Notification": {
         "type": "object",
         "description": "Represents a notification of an event relevant to the user.",

scripts/setup-docs.ts

@@ -18,6 +18,8 @@ function setupMastodonDocs(): void {
 
   const config = JSON.parse(fs.readFileSync(configPath, 'utf8'));
   const targetCommit = config.mastodonDocsCommit;
+  const overrideCommits = config.overrideCommits || [];
+  const overridesRepository = config.overridesRepository;
 
   if (!targetCommit) {
     console.error('mastodonDocsCommit not found in config.json');
@@ -52,6 +54,36 @@ function setupMastodonDocs(): void {
       cwd: docsDir,
     });
 
+    // Apply override commits if any
+    if (overrideCommits.length > 0) {
+      console.log(`Adding ${overridesRepository} overrides remote...`);
+      execSync(`git config user.email "[email protected]"`, {
+        stdio: 'inherit',
+        cwd: docsDir,
+      });
+      execSync(`git config user.name "bot"`, {
+        stdio: 'inherit',
+        cwd: docsDir,
+      });
+      execSync(`git remote add overrides ${overridesRepository} || true`, {
+        stdio: 'inherit',
+        cwd: docsDir,
+      });
+      execSync(`git fetch overrides`, {
+        stdio: 'inherit',
+        cwd: docsDir,
+      });
+
+      console.log(`Applying ${overrideCommits.length} override commit(s)...`);
+      for (const commit of overrideCommits) {
+        console.log(`Cherry-picking commit ${commit}...`);
+        execSync(`git cherry-pick ${commit}`, {
+          stdio: 'inherit',
+          cwd: docsDir,
+        });
+      }
+    }
+
     console.log('Mastodon documentation setup complete.');
   } catch (error) {
     console.error(