Revision configuration

docs/configuration-reference.md

@@ -35,6 +35,14 @@ dirigent:
     dev_packages: false
   metadata:
     mirror_vcs_repositories: false
+    retain_pruned_versions:
+      enabled: true
+      tagged_versions: true
+      dev_versions: false
+    retain_stale_revisions:
+      enabled: true
+      tagged_versions: true
+      dev_versions: false
 ```
 
 ## dirigent (root)
@@ -131,6 +139,46 @@ Fetch mirrored packages from their VCS repositories by default when possible.
 
 Sets the fetch strategy of new mirrored packages to **Fetch from VCS**.
 
+### retain_pruned_versions
+
+#### enabled
+
+Type: `boolean` | Default: `true`
+
+Whether to enable or disable retaining pruned versions of packages.
+
+#### tagged_versions
+
+Type: `boolean` | Default: `true`
+
+Retain pruned tagged package versions.
+
+#### dev_versions
+
+Type: `boolean` | Default: `false`
+
+Retain pruned development package versions.
+
+### retain_stale_revisions
+
+#### enabled
+
+Type: `boolean` | Default: `true`
+
+Whether to enable or disable retaining stale revisions of packages.
+
+#### tagged_versions
+
+Type: `boolean` | Default: `true`
+
+Retain stale revisions of tagged package versions.
+
+#### dev_versions
+
+Type: `boolean` | Default: `false`
+
+Retain stale revisions of development package versions.
+
 [iso-8601-durations]: https://en.wikipedia.org/wiki/ISO_8601#Durations
 [symfony]: https://symfony.com
 [symfony-docs-config]: https://symfony.com/doc/current/configuration.html

migrations/Version20260416081737.php

@@ -0,0 +1,36 @@
+<?php
+
+declare(strict_types=1);
+
+namespace DoctrineMigrations;
+
+use Doctrine\DBAL\Schema\Schema;
+use Doctrine\Migrations\AbstractMigration;
+
+final class Version20260416081737 extends AbstractMigration
+{
+    public function getDescription(): string
+    {
+        return '';
+    }
+
+    public function up(Schema $schema): void
+    {
+        $this->addSql(<<<'SQL'
+            ALTER TABLE version ADD pruned BOOLEAN DEFAULT NULL
+        SQL);
+        $this->addSql(<<<'SQL'
+            UPDATE version SET pruned = false
+        SQL);
+        $this->addSql(<<<'SQL'
+            ALTER TABLE version ALTER pruned SET NOT NULL
+        SQL);
+    }
+
+    public function down(Schema $schema): void
+    {
+        $this->addSql(<<<'SQL'
+            ALTER TABLE version DROP pruned
+        SQL);
+    }
+}

src/DependencyInjection/DirigentConfiguration.php

@@ -93,6 +93,32 @@ private function addMetadataSection(ArrayNodeDefinition|NodeDefinition $rootNode
                         ->defaultFalse()
                         ->info('Fetch mirrored packages from their VCS repositories by default when possible.')
                     ->end()
+                    ->arrayNode('retain_pruned_versions')
+                        ->canBeDisabled('Retain pruned package versions.')
+                        ->children()
+                            ->booleanNode('tagged_versions')
+                                ->defaultTrue()
+                                ->info('Retain pruned tagged package versions.')
+                            ->end()
+                            ->booleanNode('dev_versions')
+                                ->defaultFalse()
+                                ->info('Retain pruned development package versions.')
+                            ->end()
+                        ->end()
+                    ->end()
+                    ->arrayNode('retain_stale_revisions')
+                        ->canBeDisabled('Retain stale revisions of package versions.')
+                        ->children()
+                            ->booleanNode('tagged_versions')
+                                ->defaultTrue()
+                                ->info('Retain stale revisions of tagged package versions.')
+                            ->end()
+                            ->booleanNode('dev_versions')
+                                ->defaultFalse()
+                                ->info('Retain stale revisions of development package versions.')
+                            ->end()
+                        ->end()
+                    ->end()
                 ->end()
             ->end();
     }

src/DependencyInjection/DirigentExtension.php

@@ -56,11 +56,31 @@ private function registerEncryptionConfiguration(array $config, ContainerBuilder
     }
 
     /**
-     * @param array{mirror_vcs_repositories: bool} $config
+     * @param array{mirror_vcs_repositories: bool, retain_stale_revisions: array{enabled: bool, tagged_versions: bool, dev_versions: bool}, retain_pruned_versions: array{enabled: bool, tagged_versions: bool, dev_versions: bool}} $config
      */
     private function registerMetadataConfiguration(array $config, ContainerBuilder $container): void
     {
         $container->setParameter('dirigent.metadata.mirror_vcs_repositories', $config['mirror_vcs_repositories']);
+
+        $retainPrunedVersions = $config['retain_pruned_versions']['enabled'];
+        $container->setParameter(
+            name: 'dirigent.metadata.retain_pruned_versions.tagged_versions',
+            value: $retainPrunedVersions && $config['retain_pruned_versions']['tagged_versions'],
+        );
+        $container->setParameter(
+            name: 'dirigent.metadata.retain_pruned_versions.dev_versions',
+            value: $retainPrunedVersions && $config['retain_pruned_versions']['dev_versions'],
+        );
+
+        $retainStaleRevisions = $config['retain_stale_revisions']['enabled'];
+        $container->setParameter(
+            name: 'dirigent.metadata.retain_stale_revisions.tagged_versions',
+            value: $retainStaleRevisions && $config['retain_stale_revisions']['tagged_versions'],
+        );
+        $container->setParameter(
+            name: 'dirigent.metadata.retain_stale_revisions.dev_versions',
+            value: $retainStaleRevisions && $config['retain_stale_revisions']['dev_versions'],
+        );
     }
 
     /**

src/Doctrine/Entity/Version.php

@@ -23,6 +23,9 @@ class Version extends TrackedEntity implements \Stringable
     #[ORM\Column]
     private bool $development;
 
+    #[ORM\Column]
+    private bool $pruned = false;
+
     #[ORM\Column]
     private bool $defaultBranch = false;
 
@@ -91,6 +94,16 @@ public function setDevelopment(bool $development): void
         $this->development = $development;
     }
 
+    public function isPruned(): bool
+    {
+        return $this->pruned;
+    }
+
+    public function setPruned(bool $pruned): void
+    {
+        $this->pruned = $pruned;
+    }
+
     public function isDefaultBranch(): bool
     {
         return $this->defaultBranch;

src/Package/PackageMetadataResolver.php

@@ -23,6 +23,7 @@
 use Composer\Pcre\Preg;
 use Composer\Repository\Vcs\VcsDriverInterface;
 use Doctrine\ORM\EntityManagerInterface;
+use Symfony\Component\DependencyInjection\Attribute\Autowire;
 use Symfony\Component\Messenger\MessageBusInterface;
 use Symfony\Component\Messenger\Stamp\DispatchAfterCurrentBusStamp;
 use Symfony\Component\Messenger\Stamp\TransportNamesStamp;
@@ -36,6 +37,14 @@ public function __construct(
         private KeywordRepository $keywordRepository,
         private RegistryRepository $registryRepository,
         private PackageRepository $packageRepository,
+        #[Autowire(param: 'dirigent.metadata.retain_stale_revisions.tagged_versions')]
+        private bool $retainStaleRevisionsTagged,
+        #[Autowire(param: 'dirigent.metadata.retain_stale_revisions.dev_versions')]
+        private bool $retainStaleRevisionsDev,
+        #[Autowire(param: 'dirigent.metadata.retain_pruned_versions.tagged_versions')]
+        private bool $retainPrunedVersionsTagged,
+        #[Autowire(param: 'dirigent.metadata.retain_pruned_versions.dev_versions')]
+        private bool $retainPrunedVersionsDev,
     ) {
     }
 
@@ -204,7 +213,15 @@ private function updatePackage(Package $package, array $composerPackages, ?VcsDr
 
         // Remove outdated versions
         foreach ($existingVersionMetadata as $version) {
-            $this->entityManager->remove($version);
+            $removeVersion = $version->isDevelopment() ? !$this->retainPrunedVersionsDev : !$this->retainPrunedVersionsTagged;
+            if ($removeVersion) {
+                $this->entityManager->remove($version);
+            } else {
+                $version->setPruned(true);
+                $version->setUpdatedAt(new \DateTimeImmutable());
+
+                $this->entityManager->persist($version);
+            }
         }
 
         $package->setUpdatedAt(new \DateTimeImmutable());
@@ -214,12 +231,18 @@ private function updatePackage(Package $package, array $composerPackages, ?VcsDr
 
     private function updateVersion(Version $version, CompletePackageInterface $data, ?VcsDriverInterface $driver = null): void
     {
+        $currentMetadata = $version->hasCurrentMetadata() ? $version->getCurrentMetadata() : null;
         $metadata = $this->createMetadata($version, $data, $driver);
 
-        if (!$version->hasCurrentMetadata() || $this->hasMetadataChanged($version->getCurrentMetadata(), $metadata)) {
+        if (null === $currentMetadata || $this->hasMetadataChanged($currentMetadata, $metadata)) {
             $version->setCurrentMetadata($metadata);
 
             $this->entityManager->persist($metadata);
+
+            $removePreviousMetadata = $version->isDevelopment() ? !$this->retainStaleRevisionsDev : !$this->retainStaleRevisionsTagged;
+            if (null !== $currentMetadata && $removePreviousMetadata) {
+                $this->entityManager->remove($currentMetadata);
+            }
         }
 
         $version->setDefaultBranch($data->isDefaultBranch());