feat: add DeploymentSkippable for commit-message skip detection

composer.json

@@ -29,6 +29,7 @@
   "require": {
     "php": ">=8.2",
     "adhocore/jwt": "^1.1",
+    "utopia-php/validators": "^0.2",
     "utopia-php/cache": "^2.0",
     "utopia-php/fetch": "^1.1"
   },

src/VCS/Validator/DeploymentSkippable.php

@@ -0,0 +1,58 @@
+<?php
+
+namespace Utopia\VCS\Validator;
+
+use Utopia\Validator;
+
+class DeploymentSkippable extends Validator
+{
+    private const PATTERNS = [
+        '[skip ci]',
+        // '[ci skip]',
+        // '[no ci]',
+        // '[skip action]',
+        // '[action skip]',
+        // '[no action]',
+        // '[skip actions]',
+        // '[actions skip]',
+        // '[no actions]',
+        // '[skip deploy]',
+        // '[deploy skip]',
+        // '[no deploy]',
+        // '[skip appwrite]',
+        // '[appwrite skip]',
+        // '[no appwrite]',
+    ];
+
+    public function getDescription(): string
+    {
+        return 'Value must be a commit message containing a skip directive such as [skip ci] or [no deploy].';
+    }
+
+    public function isValid($value): bool
+    {
+        if (!is_string($value)) {
+            return false;
+        }
+
+        $value = strtolower($value);
+
+        foreach (self::PATTERNS as $pattern) {
+            if (str_contains($value, $pattern)) {
+                return true;
+            }
+        }
+
+        return false;
+    }
+
+    public function isArray(): bool
+    {
+        return false;
+    }
+
+    public function getType(): string
+    {
+        return self::TYPE_STRING;
+    }
+}

tests/VCS/Unit/Validator/DeploymentSkippableTest.php

@@ -0,0 +1,56 @@
+<?php
+
+namespace Utopia\Tests;
+
+use PHPUnit\Framework\TestCase;
+use Utopia\VCS\Validator\DeploymentSkippable;
+
+class DeploymentSkippableTest extends TestCase
+{
+    private DeploymentSkippable $validator;
+
+    protected function setUp(): void
+    {
+        $this->validator = new DeploymentSkippable();
+    }
+
+    public function testKnownSkipDirectivesSkip(): void
+    {
+        $this->assertTrue($this->validator->isValid('[skip ci] update changelog'));
+    }
+
+    public function testKnownSkipDirectivesAreCaseInsensitive(): void
+    {
+        $this->assertTrue($this->validator->isValid('[SKIP CI] update changelog'));
+    }
+
+    public function testMessageWithoutKnownDirectiveProceeds(): void
+    {
+        $this->assertFalse($this->validator->isValid('fix: real bug fix'));
+        $this->assertFalse($this->validator->isValid('feat: add new feature'));
+        $this->assertFalse($this->validator->isValid('skip deploy without brackets'));
+        $this->assertFalse($this->validator->isValid('deploy this please'));
+        $this->assertFalse($this->validator->isValid('skip-checks:true'));
+    }
+
+    public function testDirectiveCanAppearAnywhere(): void
+    {
+        $this->assertTrue($this->validator->isValid('docs: update readme [skip ci]'));
+        $this->assertTrue($this->validator->isValid('docs: update readme[skip ci]'));
+        $this->assertTrue($this->validator->isValid('prefix[skip ci]suffix'));
+        $this->assertFalse($this->validator->isValid('refactor: skip ci cache seeding'));
+    }
+
+    public function testMultilineCommitMessageSkips(): void
+    {
+        $message = "feat: add new stuff\n\nMore detail here.\n\n[skip ci]";
+
+        $this->assertTrue($this->validator->isValid($message));
+    }
+
+    public function testNonStringCommitMessageProceeds(): void
+    {
+        $this->assertFalse($this->validator->isValid(null));
+        $this->assertFalse($this->validator->isValid([]));
+    }
+}