feat: JIRA-13731 add withoutTimestamps phpstan rule

- Added rule to confirm that withoutTimestamps is used in migrations

src/PHPStan/Laravel/Migrations/RequireWithoutTimestampsRule.php

@@ -0,0 +1,55 @@
+<?php
+
+declare(strict_types=1);
+
+namespace Worksome\CodingStyle\PHPStan\Laravel\Migrations;
+
+use PhpParser\Node;
+use PHPStan\Analyser\Scope;
+use PHPStan\Rules\Rule;
+use PHPStan\Rules\RuleErrorBuilder;
+use Illuminate\Support\Str;
+
+/**
+ * Custom PHPStan rule to check if migration files using 'update' or 'insert'
+ * methods include 'withoutTimestamps' somewhere in the file.
+ */
+class RequireWithoutTimestampsRule implements Rule
+{
+    public function getNodeType(): string
+    {
+        return Node\Stmt\Class_::class;
+    }
+
+    /**
+     * @param Node\Stmt\Class_ $node
+     * @param Scope $scope
+     */
+    public function processNode(Node $node, Scope $scope): array
+    {
+        $filePath = $scope->getFile();
+
+        if (! Str::contains($filePath, 'database/migrations')) {
+            return [];
+        }
+
+        $fileContent = file_get_contents($filePath);
+
+        if (preg_match('/\b(update|insert|save|saveQuietly|create)\s*\(/', $fileContent)) {
+            if (!str_contains($fileContent, 'withoutTimestamps')) {
+                $filenameWithExtension = basename($filePath);
+                $filename = Str::before($filenameWithExtension, '.');
+
+                return [
+                    RuleErrorBuilder::message(
+                        "$filename file uses 'update' or 'create' action without 'withoutTimestamps()' protection."
+                    )
+                        ->identifier('worksome.requireWithoutTimestamps')
+                        ->build(),
+                ];
+            }
+        }
+
+        return [];
+    }
+}

tests/PHPStan/Laravel/Migrations/RequireWithoutTimestampRule/Fixture/database/migrations/invalid_migration.php.inc

@@ -0,0 +1,23 @@
+<?php
+
+use Illuminate\Database\Migrations\Migration;
+use Illuminate\Database\Schema\Blueprint;
+use Illuminate\Support\Facades\Schema;
+
+return new class extends Migration
+{
+    /**
+     * Run the migrations.
+     */
+    public function up(): void
+    {
+        Schema::table('users', function (Blueprint $table) {
+            $table->string('test', 50)
+                ->nullable();
+        });
+
+        User::withTrashed()->update([
+            'test' => 'test',
+        ]);
+    }
+};

tests/PHPStan/Laravel/Migrations/RequireWithoutTimestampRule/Fixture/database/migrations/valid_migration.php.inc

@@ -0,0 +1,25 @@
+<?php
+
+use Illuminate\Database\Migrations\Migration;
+use Illuminate\Database\Schema\Blueprint;
+use Illuminate\Support\Facades\Schema;
+
+return new class extends Migration
+{
+    /**
+     * Run the migrations.
+     */
+    public function up(): void
+    {
+        Schema::table('users', function (Blueprint $table) {
+            $table->string('test', 50)
+                ->nullable();
+        });
+
+        User::withoutTimestamps(function(){
+            User::withTrashed() ->update([
+                'test' => 'test',
+            ]);
+        });
+    }
+};

tests/PHPStan/Laravel/Migrations/RequireWithoutTimestampRule/RequireWithoutTimestampsRuleTest.php

@@ -0,0 +1,22 @@
+<?php
+
+namespace Worksome\CodingStyle\Tests\PHPStan\Laravel\EnforceKebabCaseArtisanCommandsRule;
+
+use Worksome\CodingStyle\PHPStan\Laravel\Migrations\RequireWithoutTimestampsRule;
+
+it('checks withoutTimestamps in migration rule', function (string $path, array ...$errors) {
+    $this->rule = new RequireWithoutTimestampsRule();
+
+    expect($path)->toHaveRuleErrors($errors);
+})->with([
+    'valid migration' => [
+        __DIR__ . '/Fixture/database/migrations/valid_migration.php.inc',
+    ],
+    'invalid migration' => [
+        __DIR__ . '/Fixture/database/migrations/invalid_migration.php.inc',
+        [
+            "invalid_migration file uses 'update' or 'create' action without 'withoutTimestamps()' protection.",
+            7,
+        ],
+    ],
+]);