How paulinotech1/state-gaurd works
State Guard is a local Windows/Linux endpoint auditing and JSON configuration drift/remediation tool, with CLI and Tkinter interfaces. The principal workflow loads a desired-state policy, compares it with a configuration, previews changes, and—only when explicitly applied—creates recovery material and replaces the file; rollback can restore original bytes. Endpoint indicators are read-only. The graph separates interface, audit/policy stages, JSON handling, and guarded local storage. Source excerpts show the main calls; README statements support the documented platform checks and recovery behavior.
Main entry points: state_guard.py Preview and apply · state_guard_gui.py Desktop interface · state_guard_storage.py File safety primitives · state_guard_json.py Strict JSON decode
Components 17
User interfaces
- CLI dispatcher
state_guard.py - Desktop interface
state_guard_gui.py
Audit and policy
- Endpoint checks
state_guard.py - Platform indicators
state_guard.py - Policy loading
state_guard.py - Config comparison
state_guard.py - Preview and apply
state_guard.py - Rollback checks
state_guard.py
JSON processing
- Strict JSON decode
state_guard_json.py - Minimal JSON edits
state_guard_json.py
Guarded file operations
- File safety primitives
state_guard_storage.py - Operation locks
state_guard_storage.py - Private recovery files
state_guard_storage.py - Atomic replacement
state_guard_storage.py
Other components
- CLI user
- Desktop user
- Windows/Linux settings
Connections 27
- CLI user → CLI dispatcher: runs
README.md - Desktop user → Desktop interface: uses
README.md - CLI dispatcher → Endpoint checks: dispatches
state_guard.py - CLI dispatcher → Policy loading: loads
state_guard.py - CLI dispatcher → Config comparison: checks
state_guard.py - CLI dispatcher → Preview and apply: dispatches
state_guard.py - CLI dispatcher → Rollback checks: dispatches
state_guard.py - Endpoint checks → Platform indicators: collects
state_guard.py - Platform indicators → Windows/Linux settings: reads indicators
README.md - Desktop interface → Endpoint checks: calls
state_guard_gui.py - Desktop interface → Policy loading: calls
state_guard_gui.py - Desktop interface → Config comparison: calls
state_guard_gui.py - Desktop interface → Preview and apply: calls
state_guard_gui.py - Desktop interface → Rollback checks: calls
state_guard_gui.py - Config comparison → File safety primitives: reads config
state_guard.py - Config comparison → Strict JSON decode: decodes
state_guard.py - Preview and apply → Config comparison: inspects config
state_guard.py - Preview and apply → Minimal JSON edits: renders edits
state_guard.py - Preview and apply → Operation locks: locks operation
state_guard.py - Preview and apply → Private recovery files: creates recovery
state_guard.py - Preview and apply → Atomic replacement: updates config
state_guard.py - Rollback checks → Operation locks: locks operation
state_guard.py - Rollback checks → Private recovery files: reads recovery
state_guard.py - Rollback checks → Atomic replacement: restores bytes
state_guard.py - Operation locks → File safety primitives: uses primitives
state_guard_storage.py - Private recovery files → File safety primitives: uses primitives
state_guard_storage.py - Atomic replacement → File safety primitives: uses primitives
state_guard_storage.py