Class: LocalVault::SyncState

Inherits:
Object
  • Object
show all
Defined in:
lib/localvault/sync_state.rb

Overview

Per-vault sync state tracking. Stores the checksum of secrets.enc at the time of the last successful push or pull, so the next ‘localvault sync` can determine whether local, remote, or both sides have changed.

Stored as ‘~/.localvault/vaults/<name>/.sync_state` (YAML, mode 0600). Separate from meta.yml because meta.yml is part of the SyncBundle and including sync bookkeeping there would create a checksum feedback loop.

Constant Summary collapse

FILENAME = 
".sync_state"

Instance Attribute Summary collapse

Class Method Summary collapse

Instance Method Summary collapse

Constructor Details

#initialize(vault_name) ⇒ SyncState

Returns a new instance of SyncState.



18
19
20
 
# File 'lib/localvault/sync_state.rb', line 18

def initialize(vault_name)
  @vault_name = vault_name
end

Instance Attribute Details

#vault_name ⇒ Object (readonly)

Returns the value of attribute vault_name.



16
17
18
 
# File 'lib/localvault/sync_state.rb', line 16

def vault_name
  @vault_name
end

Class Method Details

.local_checksum(store) ⇒ String?

Compute the SHA256 hex digest of a vault’s local secrets.enc.

Parameters:

  • store (Store) —

    vault store

Returns:

  • (String, nil) —

    hex digest or nil if no secrets file



65
66
67
68
69
 
# File 'lib/localvault/sync_state.rb', line 65

def self.local_checksum(store)
  bytes = store.read_encrypted
  return nil if bytes.nil? || bytes.empty?
  Digest::SHA256.hexdigest(bytes)
end

Instance Method Details

#exists? ⇒ Boolean

Returns:

  • (Boolean) 


26
27
28
 
# File 'lib/localvault/sync_state.rb', line 26

def exists?
  File.exist?(path)
end

#last_synced_at ⇒ Object 



42
43
44
 
# File 'lib/localvault/sync_state.rb', line 42

def last_synced_at
  read&.dig("last_synced_at")
end

#last_synced_checksum ⇒ Object 



38
39
40
 
# File 'lib/localvault/sync_state.rb', line 38

def last_synced_checksum
  read&.dig("last_synced_checksum")
end

#path ⇒ Object 



22
23
24
 
# File 'lib/localvault/sync_state.rb', line 22

def path
  File.join(Config.vaults_path, vault_name, FILENAME)
end

#read ⇒ Hash?

Returns parsed YAML data or nil.

Returns:

  • (Hash, nil) —

    parsed YAML data or nil



31
32
33
34
35
36
 
# File 'lib/localvault/sync_state.rb', line 31

def read
  return nil unless exists?
  YAML.safe_load_file(path)
rescue Psych::SyntaxError
  nil
end

#write!(checksum:, direction:) ⇒ Object

Record a successful sync operation.

Parameters:

  • checksum (String) —

    SHA256 hex of the local secrets.enc

  • direction (String) —

    “push” or “pull”



50
51
52
53
54
55
56
57
58
59
 
# File 'lib/localvault/sync_state.rb', line 50

def write!(checksum:, direction:)
  FileUtils.mkdir_p(File.dirname(path), mode: 0o700)
  data = {
    "last_synced_checksum" => checksum,
    "last_synced_at"       => Time.now.utc.iso8601,
    "direction"            => direction
  }
  File.write(path, YAML.dump(data))
  File.chmod(0o600, path)
end