feat: add backup commands with comprehensive capabilities (#183)

Author: Cyber-Syntax

CHANGELOG.md

@@ -1,6 +1,23 @@
 # Changelog
 All notable changes to this project will be documented in this file.
 
+## v1.1.0-alpha
+### BREAKING CHANGES
+This release implement new backup commands and features.
+Please read [wiki.md](docs/wiki.md) for more information how to use the new feature and how to migrate old backups to new format.
+
+- Added support for `backup app_name --restore-last` restore last backup
+- Added support for `backup app_name --restore-version <version>` restore backup by version
+- Added support for `backup app_name --info` show backup info
+- Added support for `backup app_name --list-backups` list all backups
+- Added support for `backup app_name --cleanup` to clean up old backups manualy(This already automaticly works when the script used tough)
+- Added support for `backup app_name --migrate` to migrate old backups to new format
+#### Migration guide
+- Keep in mind that the migration process is irreversible and will cause data loss.
+- Run `backup app_name --migrate` to migrate old backups to new format.
+- If something goes wrong, migrate manually by moving the `~/Applications/backups` directory to `~/Applications/backups.old`
+than make sure to run migrate command again to migrate the new backups to the new format.
+
 ## v1.0.1-alpha
 ## v1.0.0-alpha
 ### BREAKING CHANGES

docs/wiki.md

@@ -68,6 +68,41 @@ python run.py auth --status
 python run.py auth --remove-token
 ```
 
+### Backup
+
+#### Basic Operations
+
+```bash
+# Create backup of current version
+backup <app_name>
+
+# Restore latest backup version
+backup <app_name> --restore-last
+
+# Restore specific version
+backup <app_name> --restore-version <version>
+```
+
+#### Information & Management
+
+```bash
+# List backups for specific app
+backup <app_name> --list-backups
+
+# List all apps with backups
+backup --list-backups
+
+# Show detailed backup info
+backup <app_name> --info
+
+# Clean up old backups
+backup --cleanup                 # All apps
+backup <app_name> --cleanup      # Specific app
+
+# Migrate old backup format
+backup --migrate
+```
+
 ## 📋 Dependencies
 
 ### Core (working now)
@@ -285,11 +320,51 @@ tmp = "~/.config/my-unicorn/tmp"
 }
 ```
 
+#### Backup metadata.json implementation
+
+##### 1. **Backup Storage Structure** ✅
+
+```
+~/Applications/backups/
+  ├── appflowy/
+  │   ├── appflowy-1.2.3.AppImage
+  │   ├── appflowy-1.3.0.AppImage
+  │   └── metadata.json
+  └── obsidian/
+      ├── obsidian-1.9.1.AppImage
+      ├── obsidian-1.9.10.AppImage
+      └── metadata.json
+```
+
+##### 2. **Metadata Structure (metadata.json)** ✅
+
+> [!NOTE]
+> file path: `~/Applications/backups/obsidian/metadata.json`
+
+```json
+{
+    "versions": {
+        "1.9.1": {
+            "created": "2025-08-19T14:36:49.868125",
+            "filename": "obsidian-1.9.1.AppImage",
+            "sha256": "24471d25ed4d7d797a20a8ddf7b81ec43ae337f9ce495514dfdbb893307472b7",
+            "size": 125682911
+        },
+        "1.9.10": {
+            "created": "2025-08-19T14:01:21.787195",
+            "filename": "obsidian-1.9.10.AppImage",
+            "sha256": "24471d25ed4d7d797a20a8ddf7b81ec43ae337f9ce495514dfdbb893307472b7",
+            "size": 125682911
+        }
+    }
+}
+```
+
 ## Remove the package:
 
 > [!TIP]
 > This would remove the package if you installed globally.
 
     ```bash
     pip uninstall my-unicorn
-    ```
+    ```