Deprecate clan.auto-upgrade module with warning

Add deprecation warning that shows when the module is imported, scheduled for removal on 2025-07-15. Users should migrate to using the system.autoUpgrade NixOS option directly.

clanModules/auto-upgrade/README.md

@@ -4,5 +4,7 @@ categories = ["System"]
 features = [ "inventory", "deprecated" ]
 ---
 
+**⚠️ DEPRECATED: This module is deprecated and will be removed on 2025-07-15. Please migrate to using the system.autoUpgrade NixOS option directly.**
+
 Whether to periodically upgrade NixOS to the latest version. If enabled, a
 systemd timer will run `nixos-rebuild switch --upgrade` once a day.

clanModules/auto-upgrade/roles/default.nix

@@ -14,7 +14,9 @@ in
     };
   };
   config = {
-    system.autoUpgrade = {
+    warnings = [ "The clan.auto-upgrade module is deprecated and will be removed on 2025-07-15. Please migrate to using the system.autoUpgrade NixOS option directly." ];
+    
+    system.autoUpgrade = lib.mkIf (cfg ? flake) {
       inherit (cfg) flake;
       enable = true;
       dates = "02:00";

clanServices/auto-upgrade/default.nix

@@ -1,33 +0,0 @@
-{ ... }:
-{
-  _class = "clan.service";
-  manifest.name = "clan-core/auto-upgrade";
-  manifest.description = "Automatic system upgrade for the Clan App";
-  manifest.categories = [ "System" ];
-
-  roles.default = {
-    interface =
-      { lib, ... }:
-      {
-        options.flake = lib.mkOption {
-          type = lib.types.str;
-          description = "Flake reference";
-        };
-      };
-
-    perInstance =
-      { settings, ... }:
-      {
-        nixosModule =
-          { ... }:
-          {
-            system.autoUpgrade = {
-              inherit (settings) flake;
-              enable = true;
-              dates = "02:00";
-              randomizedDelaySec = "45min";
-            };
-          };
-      };
-  };
-}

clanServices/auto-upgrade/flake-module.nix

@@ -1,6 +0,0 @@
-{ lib, ... }:
-{
-  clan.modules = {
-    auto-upgrade = lib.modules.importApply ./default.nix { };
-  };
-}

docs/mkdocs.yml

@@ -83,7 +83,6 @@ nav:
       - Services:
           - Overview: reference/clanServices/index.md
           - reference/clanServices/admin.md
-          - reference/clanServices/auto-upgrade.md
           - reference/clanServices/borgbackup.md
           - reference/clanServices/deltachat.md
           - reference/clanServices/emergency-access.md