kamal-backup 0.3.1 → 0.4.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 801ab5f224e1e018805b65650da3c0946d6c785eb8b2a3e3e3256bcf97649abb
-  data.tar.gz: 60e98bfe053103b3405d483902a167ee2d86f7a723448e06eacb2937b56fd4d3
+  metadata.gz: 4b93c203599481320559eb006ccf07a07c010c5bc4d5dfcae3e11b7a9a832fa3
+  data.tar.gz: 705fc119fcacdd54ee431e9cfb5b88220a0faae02540cba77e38c45b94044905
 SHA512:
-  metadata.gz: b1dbd9a03222917490629d56a4bfca69e1abbac79ed241bf480ba0da50453e67e1224dcf5f6d315ce23039b31febe2d449300dae167ddf19e627decd07c6116e
-  data.tar.gz: c4392a6048ceea5ec81b20cedad84f15d864ecb37a83337571cc857de8c730c0a84629df335e9b6c4f273868ad86a6ddcc631c00315ff8ff965ac0230bcf1f5a
+  metadata.gz: fd7b30595fe843980d39979b8b7e241fbd54c7fd814c55bccb4bfcdf6b175b5767e84910929050f4e3aa40f150aec5b01e15015b196e522e3c48566f9527020f
+  data.tar.gz: e81f5d21997f6f072b9556a73b7e751accbe99098adaebaec3435ca15600e8d13f204b9d343cc3ae7f6905a86efd3abea3c5dd0d64ea602bd2f2617d8bca8fef

data/README.md

@@ -111,6 +111,7 @@ Run the first backup, check the repository, and print evidence. From an app chec
 bundle exec kamal-backup backup
 bundle exec kamal-backup list
 bundle exec kamal-backup check
+bundle exec kamal-backup unlock
 bundle exec kamal-backup evidence
 ```
 

data/lib/kamal_backup/app.rb

@@ -109,6 +109,11 @@ module KamalBackup
       restic.check.stdout
     end
 
+    def unlock
+      config.validate_restic
+      restic.unlock.stdout
+    end
+
     def prune
       config.validate_backup(check_files: false)
       restic.prune

data/lib/kamal_backup/cli.rb

@@ -191,6 +191,15 @@ module KamalBackup
       end
     end
 
+    desc 'unlock', 'Clear stale restic repository locks'
+    def unlock
+      if remote_command_mode?
+        exec_remote(%w[kamal-backup unlock])
+      else
+        print(direct_app.unlock)
+      end
+    end
+
     desc 'prune', 'Apply the configured restic retention policy and prune unneeded data'
     def prune
       if remote_command_mode?

data/lib/kamal_backup/command.rb

@@ -174,12 +174,13 @@ module KamalBackup
       end
 
       def command_failure(spec, status, stdout, stderr, redactor)
+        redacted_stderr = redactor.redact_string(stderr)
         CommandError.new(
-          "command failed (#{status}): #{spec.display(redactor)}\n#{redactor.redact_string(stderr)}",
+          "command failed (#{status}): #{spec.display(redactor)}\n#{redacted_stderr}#{restic_lock_hint(spec, stderr)}",
           command: spec,
           status: status,
           stdout: redactor.redact_string(stdout),
-          stderr: redactor.redact_string(stderr)
+          stderr: redacted_stderr
         )
       end
 
@@ -191,6 +192,14 @@ module KamalBackup
           stderr: error.message
         )
       end
+
+      def restic_lock_hint(spec, stderr)
+        return '' unless spec.argv.first == 'restic'
+        return '' if spec.argv[1] == 'unlock'
+        return '' unless stderr.to_s.match?(/repository is already locked|unlock.+stale locks/i)
+
+        "\nHint: run `kamal-backup unlock` to clear stale restic locks, then retry the command."
+      end
     end
   end
 end

data/lib/kamal_backup/restic.rb

@@ -99,6 +99,11 @@ module KamalBackup
       end
     end
 
+    def unlock
+      log('clearing stale restic locks')
+      run(%w[unlock])
+    end
+
     def check
       args = %w[check]
       args.concat(['--read-data-subset', config.check_read_data_subset]) if config.check_read_data_subset

data/lib/kamal_backup/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module KamalBackup
-  VERSION = '0.3.1'
+  VERSION = '0.4.0'
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: kamal-backup
 version: !ruby/object:Gem::Version
-  version: 0.3.1
+  version: 0.4.0
 platform: ruby
 authors:
 - crmne
 autorequire:
 bindir: exe
 cert_chain: []
-date: 2026-06-13 00:00:00.000000000 Z
+date: 2026-06-21 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: thor