Add configuration options to retain stale revisions

Author: codedmonkey

docs/configuration-reference.md

@@ -35,6 +35,10 @@ dirigent:
     dev_packages: false
   metadata:
     mirror_vcs_repositories: false
+    retain_stale_revisions:
+      enabled: true
+      tagged_versions: true
+      dev_versions: false
 ```
 
 ## dirigent (root)
@@ -131,6 +135,26 @@ Fetch mirrored packages from their VCS repositories by default when possible.
 
 Sets the fetch strategy of new mirrored packages to **Fetch from VCS**.
 
+### 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

src/DependencyInjection/DirigentConfiguration.php

@@ -93,6 +93,19 @@ private function addMetadataSection(ArrayNodeDefinition|NodeDefinition $rootNode
                         ->defaultFalse()
                         ->info('Fetch mirrored packages from their VCS repositories by default when possible.')
                     ->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,21 @@ 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}} $config
      */
     private function registerMetadataConfiguration(array $config, ContainerBuilder $container): void
     {
         $container->setParameter('dirigent.metadata.mirror_vcs_repositories', $config['mirror_vcs_repositories']);
+
+        $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'],
+        );
     }
 
     /**