Install a nightly Docker cleanup timer with init --systemd (v0.9.7)

Port of the legacy host's docker-prune.timer: 02:00 host time,
Persistent=true, docker system prune -af — but without --volumes, so
the per-repository Gradle cache volumes survive. The units are
host-global; several GitTally instances share one timer.

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>

src/main/kotlin/de/hoennig/gittally/commands/InitCommand.kt

@@ -236,10 +236,22 @@ class InitCommand(
             println("created ${envFile.toFile().relativeTo(normalizedWorkingDir.toFile())}")
         }
 
-        println("install and start the service with:")
+        // the nightly Docker cleanup is host-global: every repository generates the same
+        // units, so with several GitTally instances the symlinks simply coincide
+        val pruneServiceFile = gittallyDir.resolve(SystemdServiceFiles.PRUNE_SERVICE_NAME)
+        val pruneTimerFile = gittallyDir.resolve(SystemdServiceFiles.PRUNE_TIMER_NAME)
+        pruneServiceFile.toFile().writeText(SystemdServiceFiles.pruneServiceContent())
+        println("created ${pruneServiceFile.toFile().relativeTo(normalizedWorkingDir.toFile())}")
+        pruneTimerFile.toFile().writeText(SystemdServiceFiles.pruneTimerContent())
+        println("created ${pruneTimerFile.toFile().relativeTo(normalizedWorkingDir.toFile())}")
+
+        println("install and start the service and the nightly Docker cleanup with:")
         println("  ln -sf $unitFile ~/.config/systemd/user/$unitName")
+        println("  ln -sf $pruneServiceFile ~/.config/systemd/user/${SystemdServiceFiles.PRUNE_SERVICE_NAME}")
+        println("  ln -sf $pruneTimerFile ~/.config/systemd/user/${SystemdServiceFiles.PRUNE_TIMER_NAME}")
         println("  systemctl --user daemon-reload")
         println("  systemctl --user enable --now $unitName")
+        println("  systemctl --user enable --now ${SystemdServiceFiles.PRUNE_TIMER_NAME}")
     }
 
     private data class DetectedValues(

src/main/kotlin/de/hoennig/gittally/commands/SystemdServiceFiles.kt

@@ -10,6 +10,10 @@ import java.nio.file.Path
 object SystemdServiceFiles {
     const val ENV_FILE_NAME = "gittally.env"
 
+    /** Host-global unit names of the nightly Docker cleanup — shared by all GitTally repositories on the host. */
+    const val PRUNE_SERVICE_NAME = "gittally-docker-prune.service"
+    const val PRUNE_TIMER_NAME = "gittally-docker-prune.timer"
+
     /** Per-repository unit name, because one GitTally instance serves exactly one repository. */
     fun unitName(repoRoot: Path): String = "gittally-${sanitize(repoRoot.fileName.toString())}.service"
 
@@ -37,6 +41,37 @@ object SystemdServiceFiles {
         WantedBy=default.target
         """.trimIndent() + "\n"
 
+    /**
+     * Nightly Docker cleanup like the legacy `docker-prune.service`, but without `--volumes`:
+     * the per-repository Gradle cache volumes must survive the cleanup.
+     * Running containers and their images are never pruned, so an in-flight build is safe.
+     */
+    fun pruneServiceContent(): String =
+        """
+        [Unit]
+        Description=Clean up unused Docker containers and images (GitTally)
+
+        [Service]
+        Type=oneshot
+        # skipped (not failed) on hosts without a docker CLI
+        ExecCondition=sh -c 'command -v docker'
+        ExecStart=docker system prune -af
+        """.trimIndent() + "\n"
+
+    /** Fires before the usual auto-build slots, `Persistent=true` catches missed runs after downtime. */
+    fun pruneTimerContent(): String =
+        """
+        [Unit]
+        Description=Nightly Docker cleanup before the auto builds (GitTally)
+
+        [Timer]
+        OnCalendar=*-*-* 02:00:00
+        Persistent=true
+
+        [Install]
+        WantedBy=timers.target
+        """.trimIndent() + "\n"
+
     fun envFileContent(): String =
         """
         # EnvironmentFile for the GitTally systemd service.

src/main/resources/templates/releases.html

@@ -7,6 +7,14 @@
     <div th:replace="~{fragments :: nav(${view})}"></div>
     <div class="panel release-notes">
 
+        <h2>v0.9.7 <span class="muted">— 2026-08-10</span></h2>
+        <ul>
+            <li><code>init --systemd</code> also installs a nightly Docker cleanup timer
+                (<code>gittally-docker-prune.timer</code>, 02:00 host time): stopped containers and unused
+                images are pruned before the auto builds — like the legacy host, but the per-repository
+                Gradle cache volumes survive.</li>
+        </ul>
+
         <h2>v0.9.6 <span class="muted">— 2026-08-10</span></h2>
         <ul>
             <li>This release-notes page, linked from the version in the footer.</li>