From 33684fa20f4306d2794b374ab5c1e7291e3acae5 Mon Sep 17 00:00:00 2001
From: Tomas Votruba <tomas.vot@gmail.com>
Date: Sat, 24 Oct 2026 01:11:59 +0200
Subject: [PATCH] remove deprecated cache meta extension methods

---
 .../Contract/CacheMetaExtensionInterface.php  | 26 -------------------
 src/Config/RectorConfig.php                   | 12 ---------
 src/Configuration/Option.php                  |  5 ----
 .../Parameter/SimpleParameterProvider.php     |  1 -
 src/Configuration/RectorConfigBuilder.php     | 15 -----------
 src/Console/Command/ProcessCommand.php        |  1 -
 src/Console/Command/ValidateConfigCommand.php |  1 -
 src/Reporting/DeprecatedRulesReporter.php     | 17 ------------
 .../Command/ValidateConfigCommandTest.php     |  1 -
 9 files changed, 79 deletions(-)
 delete mode 100644 src/Caching/Contract/CacheMetaExtensionInterface.php

diff --git a/src/Caching/Contract/CacheMetaExtensionInterface.php b/src/Caching/Contract/CacheMetaExtensionInterface.php
deleted file mode 100644
index fc5baae5942..00000000000
--- a/src/Caching/Contract/CacheMetaExtensionInterface.php
+++ /dev/null
@@ -1,26 +0,0 @@
-<?php
-
-declare(strict_types=1);
-
-namespace Rector\Caching\Contract;
-
-/**
- * @api
- *
- * @deprecated Niche mechanism, no longer applied. Let Rector handle cache on its own. If custom
- * invalidation is needed, handle it in CI in a more generic way, e.g. by clearing the cache directory.
- */
-interface CacheMetaExtensionInterface
-{
-    /**
-     * Returns unique key for this cache meta entry.
-     * This describes the source of the metadata.
-     */
-    public function getKey(): string;
-
-    /**
-     * Returns hash of the cache meta entry.
-     * This represents the current state of the additional meta source.
-     */
-    public function getHash(): string;
-}
diff --git a/src/Config/RectorConfig.php b/src/Config/RectorConfig.php
index a43d1b245a8..deeb9ea9ff3 100644
--- a/src/Config/RectorConfig.php
+++ b/src/Config/RectorConfig.php
@@ -473,18 +473,6 @@ public function cacheClass(string $cacheClass): void
         Assert::isAOf($cacheClass, CacheStorageInterface::class);
     }
 
-    /**
-     * @param class-string $cacheMetaExtensionClass
-     */
-    #[Deprecated(message: <<<'TXT'
-    Niche mechanism, no longer applied. Let Rector handle cache on its own. If custom
-     invalidation is needed, handle it in CI in a more generic way, e.g. by clearing the cache directory.
-    TXT)]
-    public function cacheMetaExtension(string $cacheMetaExtensionClass): void
-    {
-        SimpleParameterProvider::addParameter(Option::CACHE_META_EXTENSIONS, $cacheMetaExtensionClass);
-    }
-
     /**
      * @see https://github.com/nikic/PHP-Parser/issues/723#issuecomment-712401963
      */
diff --git a/src/Configuration/Option.php b/src/Configuration/Option.php
index 8abd1bef860..fcd6cdcc28a 100644
--- a/src/Configuration/Option.php
+++ b/src/Configuration/Option.php
@@ -240,11 +240,6 @@ final class Option
      */
     public const string SKIPPED_NON_RECTOR_CLASSES = 'skipped_non_rector_classes';
 
-    /**
-     * @internal For reporting deprecated cache meta extensions
-     */
-    public const string CACHE_META_EXTENSIONS = 'cache_meta_extensions';
-
     /**
      * @internal For reporting deprecated withPhp53Sets() ... withPhp74Sets() methods
      */
diff --git a/src/Configuration/Parameter/SimpleParameterProvider.php b/src/Configuration/Parameter/SimpleParameterProvider.php
index 974d4abb828..df29ac160a2 100644
--- a/src/Configuration/Parameter/SimpleParameterProvider.php
+++ b/src/Configuration/Parameter/SimpleParameterProvider.php
@@ -44,7 +44,6 @@ final class SimpleParameterProvider
         Option::DEPRECATED_ATTRIBUTES_SETS_ARGS,
         Option::DEPRECATED_COMPOSER_BASED_ARGS,
         Option::LEVEL_OVERFLOWS,
-        Option::CACHE_META_EXTENSIONS,
         Option::COMPOSER_BOUND_RULE_CONFIGURATIONS,
         Option::ROOT_STANDALONE_REGISTERED_RULES,
         Option::SET_REGISTERED_RULES,
diff --git a/src/Configuration/RectorConfigBuilder.php b/src/Configuration/RectorConfigBuilder.php
index 622a72fc529..13620537266 100644
--- a/src/Configuration/RectorConfigBuilder.php
+++ b/src/Configuration/RectorConfigBuilder.php
@@ -796,21 +796,6 @@ public function withCache(
         return $this;
     }
 
-    /**
-     * @param class-string $cacheMetaExtensionClass
-     * @deprecated Niche mechanism, no longer applied. Let Rector handle cache on its own.
-     */
-    #[Deprecated(message: <<<'TXT'
-    Niche mechanism, no longer applied. Let Rector handle cache on its own. If custom
-     invalidation is needed, handle it in CI in a more generic way, e.g. by clearing the cache directory.
-    TXT)]
-    public function withCacheMetaExtension(string $cacheMetaExtensionClass): self
-    {
-        SimpleParameterProvider::addParameter(Option::CACHE_META_EXTENSIONS, $cacheMetaExtensionClass);
-
-        return $this;
-    }
-
     /**
      * @param class-string<ConfigurableRectorInterface> $rectorClass
      * @param mixed[] $configuration
diff --git a/src/Console/Command/ProcessCommand.php b/src/Console/Command/ProcessCommand.php
index c8202761d3a..43dbea9fd1b 100644
--- a/src/Console/Command/ProcessCommand.php
+++ b/src/Console/Command/ProcessCommand.php
@@ -195,7 +195,6 @@ protected function execute(InputInterface $input, OutputInterface $output): int
         // 4. Deprecations reporter
         $this->deprecatedRulesReporter->reportDeprecatedRules();
         $this->deprecatedRulesReporter->reportDeprecatedSkippedRules();
-        $this->deprecatedRulesReporter->reportDeprecatedCacheMetaExtensions();
         $this->deprecatedRulesReporter->reportDeprecatedPhpSetsMethods();
         $this->deprecatedRulesReporter->reportDeprecatedAttributesSetsArgs();
         $this->deprecatedRulesReporter->reportDeprecatedComposerBasedArgs();
diff --git a/src/Console/Command/ValidateConfigCommand.php b/src/Console/Command/ValidateConfigCommand.php
index 064cdab6ed2..eff7bf20b4c 100644
--- a/src/Console/Command/ValidateConfigCommand.php
+++ b/src/Console/Command/ValidateConfigCommand.php
@@ -59,7 +59,6 @@ protected function execute(InputInterface $input, OutputInterface $output): int
 
         $issueCount += $this->deprecatedRulesReporter->reportDeprecatedRules();
         $issueCount += $this->deprecatedRulesReporter->reportDeprecatedSkippedRules();
-        $issueCount += $this->deprecatedRulesReporter->reportDeprecatedCacheMetaExtensions();
         $issueCount += $this->deprecatedRulesReporter->reportDeprecatedPhpSetsMethods();
         $issueCount += $this->deprecatedRulesReporter->reportDeprecatedAttributesSetsArgs();
         $issueCount += $this->deprecatedRulesReporter->reportDeprecatedComposerBasedArgs();
diff --git a/src/Reporting/DeprecatedRulesReporter.php b/src/Reporting/DeprecatedRulesReporter.php
index 36d64aee3b0..322d01cb22c 100644
--- a/src/Reporting/DeprecatedRulesReporter.php
+++ b/src/Reporting/DeprecatedRulesReporter.php
@@ -57,23 +57,6 @@ public function reportDeprecatedSkippedRules(): int
         return $reportedCount;
     }
 
-    public function reportDeprecatedCacheMetaExtensions(): int
-    {
-        /** @var string[] $cacheMetaExtensions */
-        $cacheMetaExtensions = SimpleParameterProvider::provideArrayParameter(Option::CACHE_META_EXTENSIONS);
-
-        $reportedCount = 0;
-        foreach ($cacheMetaExtensions as $cacheMetumExtension) {
-            $this->symfonyStyle->warning(sprintf(
-                'Cache meta extension "%s" is deprecated and no longer applied. It is a niche mechanism, let Rector handle cache on its own. If custom invalidation is needed, handle it in CI in a more generic way, e.g. by clearing the cache directory.',
-                $cacheMetumExtension
-            ));
-            ++$reportedCount;
-        }
-
-        return $reportedCount;
-    }
-
     public function reportDeprecatedPhpSetsMethods(): int
     {
         /** @var string[] $deprecatedPhpSetsMethods */
diff --git a/tests/Console/Command/ValidateConfigCommandTest.php b/tests/Console/Command/ValidateConfigCommandTest.php
index c2b2cf61550..f15f79ba1e4 100644
--- a/tests/Console/Command/ValidateConfigCommandTest.php
+++ b/tests/Console/Command/ValidateConfigCommandTest.php
@@ -36,7 +36,6 @@ protected function setUp(): void
             Option::SKIPPED_NON_RECTOR_CLASSES,
             Option::SKIPPED_RECTOR_RULES,
             Option::SKIPPED_START_WITH_SHORT_OPEN_TAG_FILES,
-            Option::CACHE_META_EXTENSIONS,
             Option::DEPRECATED_PHP_SETS_METHODS,
             Option::DEPRECATED_ATTRIBUTES_SETS_ARGS,
             Option::DEPRECATED_COMPOSER_BASED_ARGS,