machineconfig 3.99__py3-none-any.whl → 7.66__py3-none-any.whl

machineconfig/utils/links.py

@@ -1,12 +1,65 @@
-from machineconfig.utils.path_extended import PathExtended as PathExtended, PLike
+from machineconfig.utils.path_extended import PathExtended, PLike
+from machineconfig.profile.create_links_export import ON_CONFLICT_STRICT
 from machineconfig.utils.accessories import randstr
 from rich.console import Console
 from rich.panel import Panel
-
+import hashlib
+from typing import TypedDict, Literal
 
 console = Console()
 
 
+ActionType = Literal[
+    "already_linked",
+    "relinking",
+    "fixing_broken_link",
+    "identical_files",
+    "backupConfigDefaultPath",
+    "backing_up_source",
+    "backing_up_target",
+    "relink2newSelfManagedPath",
+    "relinking_to_new_target",
+    "move2selfManagedPath",
+    "moving_to_target",
+    "new_link",
+    "newLinkAndSelfManagedPath",
+    "new_link_and_target",
+    "linking",
+    "copying",
+    "error"
+]
+
+
+class OperationResult(TypedDict):
+    action: ActionType
+    details: str
+
+class OperationRecord(TypedDict):
+    action: ActionType
+    details: str
+    program: str
+    file_key: str
+    defaultPath: str
+    selfManaged: str
+    operation: str
+    status: str
+
+
+def files_are_identical(file1: PathExtended, file2: PathExtended) -> bool:
+    """Check if two files are identical by comparing their SHA256 hashes."""
+    def get_file_hash(path: PathExtended) -> str:
+        hash_sha256 = hashlib.sha256()
+        with open(path, "rb") as f:
+            for chunk in iter(lambda: f.read(4096), b""):
+                hash_sha256.update(chunk)
+        return hash_sha256.hexdigest()
+    
+    try:
+        return get_file_hash(file1) == get_file_hash(file2)
+    except (OSError, IOError):
+        return False
+
+
 def build_links(target_paths: list[tuple[PLike, str]], repo_root: PLike):
     """Build symboic links from various relevant paths (e.g. data) to `repo_root/links/<name>` to facilitate easy access from
     tree explorer of the IDE.
@@ -28,134 +81,290 @@ def build_links(target_paths: list[tuple[PLike, str]], repo_root: PLike):
     tmp_results_root.mkdir(parents=True, exist_ok=True)
     target_dirs_filtered.append((tmp_results_root, "tmp_results"))
 
+    links_dir = repo_root_obj.joinpath("links")
+    links_dir.mkdir(parents=True, exist_ok=True)
+    
     for a_target_path, a_name in target_dirs_filtered:
-        links_path = repo_root_obj.joinpath("links", a_name)
-        links_path.symlink_to(target=a_target_path)
+        links_path = links_dir.joinpath(a_name)
+        if links_path.exists() or links_path.is_symlink():
+            if links_path.is_symlink() and links_path.resolve() == a_target_path.resolve():
+                continue
+            links_path.unlink(missing_ok=True)
+        try:
+            links_path.symlink_to(target=a_target_path)
+        except OSError as ex:
+            console.print(Panel(f"❌ Failed to create symlink {links_path} -> {a_target_path}: {ex}", title="Symlink Error", expand=False))
 
 
-def symlink_func(this: PathExtended, to_this: PathExtended, prioritize_to_this: bool):
-    """helper function. creates a symlink from `this` to `to_this`.
+def symlink_map(config_file_default_path: PathExtended, self_managed_config_file_path: PathExtended,
+                 on_conflict: ON_CONFLICT_STRICT
+                 ) -> OperationResult:
+    """helper function. creates a symlink from `config_file_default_path` to `self_managed_config_file_path`.
 
-    this: exists           AND    to_this exists            AND this is a symlink pointing to to_this              ===> Resolution: AUTO: do nothing, already linked correctly.
-    this: exists           AND    to_this exists            AND this is a symlink pointing to somewhere else       ===> Resolution: AUTO: delete this symlink, create symlink to to_this
-    this: exists           AND    to_this exists            AND this is a concrete path                            ===> Resolution: DANGER: require user input to decide (param prioritize_to_this). Give two options: 1) prioritize `this`: to_this is backed up as to_this.orig_<randstr()>, to_this is deleted,  and symlink is created from this to to_this as normal; 2) prioritize `to_this`: `this` is backed up as this.orig_<randstr()>, `this` is deleted, and symlink is created from this to to_this as normal.
+    Returns a dict with 'action' and 'details' keys describing what was done.
 
-    this: exists           AND    to_this doesn't exist     AND this is a symlink pointing to somewhere else       ===> Resolution: AUTO: delete this symlink, create symlink to to_this (touch to_this)
-    this: exists           AND    to_this doesn't exist     AND this is a symlink pointing to to_this              ===> Resolution: AUTO: delete this symlink, create symlink to to_this (touch to_this)
-    this: exists           AND    to_this doesn't exist     AND this is a concrete path                            ===> Resolution: AUTO: move this to to_this, then create symlink from this to to_this.
+    on_conflict strategies:
+    - throw-error: Raise exception when files differ
+    - overwrite-self-managed: Delete self_managed_config_file_path (self-managed), move config_file_default_path to self_managed_config_file_path, create symlink
+    - backup-self-managed: Backup self_managed_config_file_path (self-managed), move config_file_default_path to self_managed_config_file_path, create symlink
+    - overwrite-default-path: Delete config_file_default_path (default path), create symlink to self_managed_config_file_path
+    - backup-default-path: Backup config_file_default_path (default path), create symlink to self_managed_config_file_path
 
-    this: doesn't exist    AND    to_this exists                                                                   ===> Resolution: AUTO: create link from this to to_this
-    this: doesn't exist    AND    to_this doesn't exist                                                            ===> Resolution: AUTO: create link from this to to_this (touch to_this)
+    Note: `config_file_default_path` is the default system location, `self_managed_config_file_path` is the self-managed config location
 
     """
-    this = PathExtended(this).expanduser().absolute()
-    to_this = PathExtended(to_this).expanduser().absolute()
+    config_file_default_path = PathExtended(config_file_default_path).expanduser().absolute()
+    self_managed_config_file_path = PathExtended(self_managed_config_file_path).expanduser().absolute()
+    
+    if config_file_default_path.resolve() == self_managed_config_file_path.resolve():
+        raise ValueError(f"config_file_default_path and self_managed_config_file_path resolve to the same location: {config_file_default_path.resolve()}")
+    
+    action_taken = ""
+    details = ""
+    
+    # Handle broken symlinks first - they exist as symlinks but point to non-existent targets
+    if config_file_default_path.is_symlink() and not config_file_default_path.exists():
+        action_taken = "fixing_broken_link"
+        details = "Removed broken symlink and will create new one"
+        console.print(Panel(f"🔄 FIXING BROKEN LINK | Removing broken symlink {config_file_default_path}, will create link to {self_managed_config_file_path}", title="Fixing Broken Link", expand=False))
+        config_file_default_path.unlink()
+    
     # Case analysis based on docstring
-    if this.exists():
-        if to_this.exists():
-            if this.is_symlink():
+    if config_file_default_path.exists():
+        if self_managed_config_file_path.exists():
+            if config_file_default_path.is_symlink():
                 # Check if symlink already points to correct target
                 try:
-                    if this.readlink().resolve() == to_this.resolve():
-                        # Case: this exists AND to_this exists AND this is a symlink pointing to to_this
-                        console.print(Panel(f"✅ ALREADY LINKED | {this} ➡️  {to_this}", title="Already Linked", expand=False))
-                        return
+                    if config_file_default_path.resolve() == self_managed_config_file_path.resolve():
+                        # Case: config_file_default_path exists AND self_managed_config_file_path exists AND config_file_default_path is a symlink pointing to self_managed_config_file_path
+                        action_taken = "already_linked"
+                        details = "Symlink already correctly points to target"
+                        console.print(Panel(f"✅ ALREADY LINKED | {config_file_default_path} ➡️  {self_managed_config_file_path}", title="Already Linked", expand=False))
+                        return {"action": action_taken, "details": details}
                     else:
-                        # Case: this exists AND to_this exists AND this is a symlink pointing to somewhere else
-                        console.print(Panel(f"🔄 RELINKING | Updating symlink from {this} ➡️  {to_this}", title="Relinking", expand=False))
-                        this.delete(sure=True)
+                        # Case: config_file_default_path exists AND self_managed_config_file_path exists AND config_file_default_path is a symlink pointing to somewhere else
+                        action_taken = "relinking"
+                        details = "Updated existing symlink to point to new target"
+                        console.print(Panel(f"🔄 RELINKING | Updating symlink from {config_file_default_path} ➡️  {self_managed_config_file_path}", title="Relinking", expand=False))
+                        config_file_default_path.delete(sure=True)
                 except OSError:
                     # Broken symlink case
-                    console.print(Panel(f"🔄 FIXING BROKEN LINK | Fixing broken symlink from {this} ➡️  {to_this}", title="Fixing Broken Link", expand=False))
-                    this.delete(sure=True)
+                    action_taken = "fixing_broken_link"
+                    details = "Removed broken symlink and will create new one"
+                    console.print(Panel(f"🔄 FIXING BROKEN LINK | Fixing broken symlink from {config_file_default_path} ➡️  {self_managed_config_file_path}", title="Fixing Broken Link", expand=False))
+                    config_file_default_path.delete(sure=True)
             else:
-                # Case: this exists AND to_this exists AND this is a concrete path
-                if prioritize_to_this:
-                    # prioritize `to_this`: `this` is backed up, `this` is deleted, symlink created
-                    backup_name = f"{this}.orig_{randstr()}"
-                    console.print(Panel(f"📦 BACKING UP | Moving {this} to {backup_name}, prioritizing {to_this}", title="Backing Up", expand=False))
-                    this.move(path=backup_name)
+                # Case: config_file_default_path exists AND self_managed_config_file_path exists AND config_file_default_path is a concrete path
+                if files_are_identical(config_file_default_path, self_managed_config_file_path):
+                    # Files are identical, just delete this and create symlink
+                    action_taken = "identical_files"
+                    details = "Files identical, removed config_file_default_path and will create symlink"
+                    console.print(Panel(f"🔗 IDENTICAL FILES | Files are identical, deleting {config_file_default_path} and creating symlink to {self_managed_config_file_path}", title="Identical Files", expand=False))
+                    config_file_default_path.delete(sure=True)
                 else:
-                    # prioritize `this`: to_this is backed up, to_this is deleted, this content moved to to_this location
-                    backup_name = f"{to_this}.orig_{randstr()}"
-                    console.print(Panel(f"📦 BACKING UP | Moving {to_this} to {backup_name}, prioritizing {this}", title="Backing Up", expand=False))
-                    to_this.move(path=backup_name)
-                    this.move(path=to_this)
+                    # Files are different, use on_conflict strategy
+                    import subprocess
+                    command = f"""delta --side-by-side "{config_file_default_path}" "{self_managed_config_file_path}" """
+                    try:
+                        console.print(Panel(f"🆘 CONFLICT DETECTED | Showing diff between {config_file_default_path} and {self_managed_config_file_path}", title="Conflict Detected", expand=False))
+                        subprocess.run(command, shell=True, check=True)
+                    except Exception:
+                        console.print(Panel("⚠️ Could not show diff using 'delta'. Please install 'delta' for better diff visualization.", title="Delta Not Found", expand=False))
+
+                    match on_conflict:
+                        case "throw-error":
+                            raise RuntimeError(f"Conflict detected: {config_file_default_path} and {self_managed_config_file_path} both exist with different content")
+                        case "overwrite-self-managed":
+                            action_taken = "backing_up_target"
+                            details = "Overwriting self-managed config, moving default path to self-managed location"
+                            console.print(Panel(f"📦 OVERWRITE SELF-MANAGED | Deleting {self_managed_config_file_path}, moving {config_file_default_path} to {self_managed_config_file_path}", title="Overwrite Self-Managed", expand=False))
+                            self_managed_config_file_path.delete(sure=True)
+                            config_file_default_path.move(path=self_managed_config_file_path)
+                        case "backup-self-managed":
+                            backup_name = f"{self_managed_config_file_path}.orig_{randstr()}"
+                            action_taken = "backing_up_target"
+                            details = f"Backed up self-managed config to {backup_name}"
+                            console.print(Panel(f"📦 BACKUP SELF-MANAGED | Moving {self_managed_config_file_path} to {backup_name}, moving {config_file_default_path} to {self_managed_config_file_path}", title="Backup Self-Managed", expand=False))
+                            self_managed_config_file_path.move(path=backup_name)
+                            config_file_default_path.move(path=self_managed_config_file_path)
+                        case "overwrite-default-path":
+                            action_taken = "backupConfigDefaultPath"
+                            details = "Overwriting default path, creating symlink to self-managed config"
+                            console.print(Panel(f"📦 OVERWRITE DEFAULT | Deleting {config_file_default_path}, creating symlink to {self_managed_config_file_path}", title="Overwrite Default", expand=False))
+                            config_file_default_path.delete(sure=True)
+                        case "backup-default-path":
+                            backup_name = f"{config_file_default_path}.orig_{randstr()}"
+                            action_taken = "backupConfigDefaultPath"
+                            details = f"Backed up default path to {backup_name}"
+                            console.print(Panel(f"📦 BACKUP DEFAULT | Moving {config_file_default_path} to {backup_name}, creating symlink to {self_managed_config_file_path}", title="Backup Default", expand=False))
+                            config_file_default_path.move(path=backup_name)
         else:
-            # to_this doesn't exist
-            if this.is_symlink():
-                # Case: this exists AND to_this doesn't exist AND this is a symlink (pointing anywhere)
-                console.print(Panel(f"🔄 RELINKING | Updating symlink from {this} ➡️  {to_this}", title="Relinking", expand=False))
-                this.delete(sure=True)
-                # Create to_this
-                to_this.parent.mkdir(parents=True, exist_ok=True)
-                to_this.touch()
+            # self_managed_config_file_path doesn't exist
+            if config_file_default_path.is_symlink():
+                # Case: config_file_default_path exists AND self_managed_config_file_path doesn't exist AND config_file_default_path is a symlink (pointing anywhere)
+                action_taken = "relink2newSelfManagedPath"
+                details = "Removed existing symlink, will create self_managed_config_file_path and new symlink"
+                console.print(Panel(f"🔄 RELINKING | Updating symlink from {config_file_default_path} ➡️  {self_managed_config_file_path}", title="Relinking", expand=False))
+                config_file_default_path.delete(sure=True)
+                # Create self_managed_config_file_path
+                self_managed_config_file_path.parent.mkdir(parents=True, exist_ok=True)
+                self_managed_config_file_path.touch()
             else:
-                # Case: this exists AND to_this doesn't exist AND this is a concrete path
-                console.print(Panel(f"📁 MOVING | Moving {this} to {to_this}, then creating symlink", title="Moving", expand=False))
-                this.move(path=to_this)
+                # Case: config_file_default_path exists AND self_managed_config_file_path doesn't exist AND config_file_default_path is a concrete path
+                action_taken = "move2selfManagedPath"
+                details = "Moved config_file_default_path to self_managed_config_file_path location, will create symlink"
+                console.print(Panel(f"📁 MOVING | Moving {config_file_default_path} to {self_managed_config_file_path}, then creating symlink", title="Moving", expand=False))
+                config_file_default_path.move(path=self_managed_config_file_path)
     else:
-        # this doesn't exist
-        if to_this.exists():
-            # Case: this doesn't exist AND to_this exists
-            console.print(Panel(f"🆕 NEW LINK | Creating new symlink from {this} ➡️  {to_this}", title="New Link", expand=False))
+        # config_file_default_path doesn't exist
+        if self_managed_config_file_path.exists():
+            # Case: config_file_default_path doesn't exist AND self_managed_config_file_path exists
+            action_taken = "new_link"
+            details = "Creating new symlink to existing self_managed_config_file_path"
+            console.print(Panel(f"🆕 NEW LINK | Creating new symlink from {config_file_default_path} ➡️  {self_managed_config_file_path}", title="New Link", expand=False))
         else:
-            # Case: this doesn't exist AND to_this doesn't exist
-            console.print(Panel(f"🆕 NEW LINK & TARGET | Creating {to_this} and symlink from {this} ➡️  {to_this}", title="New Link & Target", expand=False))
-            to_this.parent.mkdir(parents=True, exist_ok=True)
-            to_this.touch()
+            # Case: config_file_default_path doesn't exist AND self_managed_config_file_path doesn't exist
+            action_taken = "newLinkAndSelfManagedPath"
+            details = "Creating self_managed_config_file_path file and new symlink"
+            console.print(Panel(f"🆕 NEW LINK & TARGET | Creating {self_managed_config_file_path} and symlink from {config_file_default_path} ➡️  {self_managed_config_file_path}", title="New Link & Target", expand=False))
+            self_managed_config_file_path.parent.mkdir(parents=True, exist_ok=True)
+            self_managed_config_file_path.touch()
+    
     # Create the symlink
     try:
-        console.print(Panel(f"🔗 LINKING | Creating symlink from {this} ➡️  {to_this}", title="Linking", expand=False))
-        PathExtended(this).symlink_to(target=to_this, verbose=True, overwrite=True)
+        if not action_taken:
+            action_taken = "linking"
+            details = "Creating symlink"
+            console.print(Panel(f"🔗 LINKING | Creating symlink from {config_file_default_path} ➡️  {self_managed_config_file_path}", title="Linking", expand=False))
+        PathExtended(config_file_default_path).symlink_to(target=self_managed_config_file_path, verbose=True, overwrite=False)
+        return {"action": action_taken, "details": details}
     except Exception as ex:
-        console.print(Panel(f"❌ ERROR | Failed at linking {this} ➡️  {to_this}. Reason: {ex}", title="Error", expand=False))
+        action_taken = "error"
+        details = f"Failed to create symlink: {str(ex)}"
+        console.print(Panel(f"❌ ERROR | Failed at linking {config_file_default_path} ➡️  {self_managed_config_file_path}. Reason: {ex}", title="Error", expand=False))
+        return {"action": action_taken, "details": details}
 
 
-def symlink_copy(this: PathExtended, to_this: PathExtended, prioritize_to_this: bool):
-    this = PathExtended(this).expanduser().absolute()
-    to_this = PathExtended(to_this).expanduser().absolute()
-    if this.exists():
-        if to_this.exists():
-            if this.is_symlink():
+def copy_map(config_file_default_path: PathExtended, self_managed_config_file_path: PathExtended, on_conflict: ON_CONFLICT_STRICT) -> OperationResult:
+    config_file_default_path = PathExtended(config_file_default_path).expanduser().absolute()
+    self_managed_config_file_path = PathExtended(self_managed_config_file_path).expanduser().absolute()
+    
+    if config_file_default_path.resolve() == self_managed_config_file_path.resolve():
+        raise ValueError(f"config_file_default_path and self_managed_config_file_path resolve to the same location: {config_file_default_path.resolve()}")
+    
+    action_taken = ""
+    details = ""
+    
+    # Handle broken symlinks first - they exist as symlinks but point to non-existent targets
+    if config_file_default_path.is_symlink() and not config_file_default_path.exists():
+        action_taken = "fixing_broken_link"
+        details = "Removed broken symlink and will copy new file"
+        console.print(Panel(f"🔄 FIXING BROKEN LINK | Removing broken symlink {config_file_default_path}, will copy from {self_managed_config_file_path}", title="Fixing Broken Link", expand=False))
+        config_file_default_path.unlink()
+    
+    match (config_file_default_path.exists(), self_managed_config_file_path.exists()):
+        case (True, True):
+            # Both files exist
+            if config_file_default_path.is_symlink():
                 try:
-                    if this.readlink().resolve() == to_this.resolve():
-                        console.print(Panel(f"✅ ALREADY LINKED | {this} ➡️  {to_this}", title="Already Linked", expand=False))
-                        return
+                    if config_file_default_path.resolve() == self_managed_config_file_path.resolve():
+                        action_taken = "already_linked"
+                        details = "File at default path is already a symlink to self-managed config"
+                        console.print(Panel(f"✅ ALREADY CORRECT | {config_file_default_path} already points to {self_managed_config_file_path}", title="Already Correct", expand=False))
+                        return {"action": action_taken, "details": details}
                     else:
-                        console.print(Panel(f"🔄 RELINKING | Updating symlink from {this} ➡️  {to_this}", title="Relinking", expand=False))
-                        this.delete(sure=True)
+                        action_taken = "relinking"
+                        details = "Removing symlink at default path that points elsewhere"
+                        console.print(Panel(f"🔄 REMOVING SYMLINK | Removing symlink {config_file_default_path} (points elsewhere), will copy from {self_managed_config_file_path}", title="Removing Symlink", expand=False))
+                        config_file_default_path.delete(sure=True)
                 except OSError:
-                    console.print(Panel(f"🔄 FIXING BROKEN LINK | Fixing broken symlink from {this} ➡️  {to_this}", title="Fixing Broken Link", expand=False))
-                    this.delete(sure=True)
+                    action_taken = "fixing_broken_link"
+                    details = "Removed broken symlink at default path"
+                    console.print(Panel(f"🔄 FIXING BROKEN SYMLINK | Removing broken symlink {config_file_default_path}, will copy from {self_managed_config_file_path}", title="Fixing Broken Symlink", expand=False))
+                    config_file_default_path.delete(sure=True)
             else:
-                if prioritize_to_this:
-                    backup_name = f"{this}.orig_{randstr()}"
-                    console.print(Panel(f"📦 BACKING UP | Moving {this} to {backup_name}, prioritizing {to_this}", title="Backing Up", expand=False))
-                    this.move(path=backup_name)
+                # Check if files are identical first
+                if files_are_identical(config_file_default_path, self_managed_config_file_path):
+                    # Files are identical, just delete this and proceed with copy
+                    action_taken = "identical_files"
+                    details = "Files identical, removed config_file_default_path and will copy"
+                    console.print(Panel(f"🔗 IDENTICAL FILES | Files are identical, deleting {config_file_default_path} and copying from {self_managed_config_file_path}", title="Identical Files", expand=False))
+                    config_file_default_path.delete(sure=True)
                 else:
-                    backup_name = f"{to_this}.orig_{randstr()}"
-                    console.print(Panel(f"📦 BACKING UP | Moving {to_this} to {backup_name}, prioritizing {this}", title="Backing Up", expand=False))
-                    to_this.move(path=backup_name)
-                    this.move(path=to_this)
-        else:
-            if this.is_symlink():
-                console.print(Panel(f"🔄 RELINKING | Updating symlink from {this} ➡️  {to_this}", title="Relinking", expand=False))
-                this.delete(sure=True)
-                to_this.parent.mkdir(parents=True, exist_ok=True)
-                to_this.touch()
+                    # Files are different, use on_conflict strategy
+                    import subprocess
+                    command = f"""delta --side-by-side "{config_file_default_path}" "{self_managed_config_file_path}" """
+                    try:
+                        console.print(Panel(f"🆘 CONFLICT DETECTED | Showing diff between {config_file_default_path} and {self_managed_config_file_path}", title="Conflict Detected", expand=False))
+                        subprocess.run(command, shell=True, check=True)
+                    except Exception:
+                        console.print(Panel("⚠️ Could not show diff using 'delta'. Please install 'delta' for better diff visualization.", title="Delta Not Found", expand=False))
+
+                    match on_conflict:
+                        case "throw-error":
+                            raise RuntimeError(f"Conflict detected: {config_file_default_path} and {self_managed_config_file_path} both exist with different content")
+                        case "overwrite-self-managed":
+                            action_taken = "backing_up_target"
+                            details = "Overwriting self-managed config with default path content"
+                            console.print(Panel(f"📦 OVERWRITE SELF-MANAGED | Deleting {self_managed_config_file_path}, moving {config_file_default_path} to {self_managed_config_file_path}", title="Overwrite Self-Managed", expand=False))
+                            self_managed_config_file_path.delete(sure=True)
+                            config_file_default_path.move(path=self_managed_config_file_path)
+                        case "backup-self-managed":
+                            backup_name = f"{self_managed_config_file_path}.orig_{randstr()}"
+                            action_taken = "backing_up_target"
+                            details = f"Backed up self-managed config to {backup_name}"
+                            console.print(Panel(f"📦 BACKUP SELF-MANAGED | Moving {self_managed_config_file_path} to {backup_name}, moving {config_file_default_path} to {self_managed_config_file_path}", title="Backup Self-Managed", expand=False))
+                            self_managed_config_file_path.move(path=backup_name)
+                            config_file_default_path.move(path=self_managed_config_file_path)
+                        case "overwrite-default-path":
+                            action_taken = "backupConfigDefaultPath"
+                            details = "Overwriting default path with self-managed config"
+                            console.print(Panel(f"📦 OVERWRITE DEFAULT | Deleting {config_file_default_path}, will copy from {self_managed_config_file_path}", title="Overwrite Default", expand=False))
+                            config_file_default_path.delete(sure=True)
+                        case "backup-default-path":
+                            backup_name = f"{config_file_default_path}.orig_{randstr()}"
+                            action_taken = "backupConfigDefaultPath"
+                            details = f"Backed up default path to {backup_name}"
+                            console.print(Panel(f"📦 BACKUP DEFAULT | Moving {config_file_default_path} to {backup_name}, will copy from {self_managed_config_file_path}", title="Backup Default", expand=False))
+                            config_file_default_path.move(path=backup_name)
+        case (True, False):
+            # config_file_default_path exists, self_managed_config_file_path doesn't
+            if config_file_default_path.is_symlink():
+                action_taken = "relink2newSelfManagedPath"
+                details = "Removed existing symlink, will create self_managed_config_file_path and copy"
+                console.print(Panel(f"🔄 REMOVING SYMLINK | Removing symlink {config_file_default_path}, creating {self_managed_config_file_path}", title="Removing Symlink", expand=False))
+                config_file_default_path.delete(sure=True)
+                self_managed_config_file_path.parent.mkdir(parents=True, exist_ok=True)
+                self_managed_config_file_path.touch()
             else:
-                console.print(Panel(f"📁 MOVING | Moving {this} to {to_this}, then copying", title="Moving", expand=False))
-                this.move(path=to_this)
-    else:
-        if to_this.exists():
-            console.print(Panel(f"🆕 NEW LINK | Copying {to_this} to {this}", title="New Link", expand=False))
-        else:
-            console.print(Panel(f"🆕 NEW LINK & TARGET | Creating {to_this} and copying to {this}", title="New Link & Target", expand=False))
-            to_this.parent.mkdir(parents=True, exist_ok=True)
-            to_this.touch()
+                action_taken = "move2selfManagedPath"
+                details = "Moved config_file_default_path to self_managed_config_file_path location, will copy back"
+                console.print(Panel(f"📁 MOVING | Moving {config_file_default_path} to {self_managed_config_file_path}, then copying back", title="Moving", expand=False))
+                config_file_default_path.move(path=self_managed_config_file_path)
+        case (False, True):
+            # config_file_default_path doesn't exist, self_managed_config_file_path does
+            action_taken = "new_link"
+            details = "Copying existing self_managed_config_file_path to config_file_default_path location"
+            console.print(Panel(f"🆕 NEW COPY | Copying {self_managed_config_file_path} to {config_file_default_path}", title="New Copy", expand=False))
+        case (False, False):
+            # Neither exists
+            action_taken = "newLinkAndSelfManagedPath"
+            details = "Creating self_managed_config_file_path file and copying to config_file_default_path"
+            console.print(Panel(f"🆕 NEW FILE & COPY | Creating {self_managed_config_file_path} and copying to {config_file_default_path}", title="New File & Copy", expand=False))
+            self_managed_config_file_path.parent.mkdir(parents=True, exist_ok=True)
+            self_managed_config_file_path.touch()
+    
     try:
-        console.print(Panel(f"📋 COPYING | Copying {to_this} to {this}", title="Copying", expand=False))
-        to_this.copy(path=this, overwrite=True, verbose=True)
+        if not action_taken:
+            action_taken = "copying"
+            details = "Copying file"
+            console.print(Panel(f"📋 COPYING | Copying {self_managed_config_file_path} to {config_file_default_path}", title="Copying", expand=False))
+        self_managed_config_file_path.copy(path=config_file_default_path, overwrite=True, verbose=True)
+        return {"action": action_taken, "details": details}
     except Exception as ex:
-        console.print(Panel(f"❌ ERROR | Failed at copying {to_this} to {this}. Reason: {ex}", title="Error", expand=False))
+        action_taken = "error"
+        details = f"Failed to copy file: {str(ex)}"
+        console.print(Panel(f"❌ ERROR | Failed at copying {self_managed_config_file_path} to {config_file_default_path}. Reason: {ex}", title="Error", expand=False))
+        return {"action": action_taken, "details": details}
+
+