FileHistory

---

Object Hierarchy:

Description:

Content:

Properties:

• public int agent_id { get; set; }
  Agent identifier (0 for now, may be used later to track which agent/tool made the change).
• public string alias_target { get; set; }
  Target path if file was previously an alias (symlink target). Empty string "" if file was not an alias. Stored for restoration purposes.
• public string backup_path { get; set; }
  Path where the old version will be saved (empty string "" for new files). This is the path where FileHistory class will save the backup of the original file. Used for restoration if change is rejected.
• public string base_type { get; set; }
  The file type before it was changed (matches filebase base_type standard). Type identifiers: "f" = File, "d" = Folder/Directory, "fa" = FileAlias (alias/symlink).
• public string change_type { get; set; }
  Change type: "added", "modified", or "deleted". User-friendly: "file X was deleted", "file Y was modified", "file Z was added".
• public int64 filebase_id { get; set; }
  Reference to filebase record (0 for new files or deleted files). Deleted files are removed from filebase.
• public int64 id { get; set; }
  Database ID.
• public string moved_from { get; set; }
  Source path (for rename operations when file was added - file was moved from here). For renames: change_type="added", path = new path, moved_from = original path. Empty string "" for non-rename operations (regular add, delete, modify).
• public string moved_to { get; set; }
  Destination path (for rename operations when file was deleted - file was moved to here). For renames: change_type="deleted", path = original path, moved_to = destination path. Empty string "" for non- rename operations (regular delete, add, modify).
• public string path { get; set; }
  The file path (primary identifier - what user cares about).
• public int status { get; set; }
  User approval state (0 = pending, 1 = approved, -1 = rejected). - 0 = pending (not yet reviewed) - 1 = approved (user approved the change) - -1 = rejected (user rejected the change)
• public int64 timestamp { get; set; }
  When the change occurred (when file was removed or changed). For overlay/command execution updates, all timestamps for the same command/run/edit should be the same (based on when the command/run/edit started, NOT when the record was created).

Static methods:

• public static async void cleanup_old_backups (Database db, int max_deleted_days = 30)
  Cleanup old backup files from the backup directory and database records.
• public static void init_db (Database db)
  Initialize file_history table in database.
• public static Query<FileHistory> query (Database db)
  Create a query object for file_history table.

Creation methods:

• public FileHistory (Database db, FileBase filebase_object, string change_type, DateTime timestamp)
  Constructor - creates a FileHistory object for a change.

Methods:

• public async void commit () throws Error
  Commit the change to database.
• public void unlink ()
  Delete the backup file from disk.

Inherited Members: