machineconfig 8.14__py3-none-any.whl → 8.50__py3-none-any.whl

machineconfig/scripts/python/{helpers_devops → helpers/helpers_devops}/cli_self.py

@@ -1,6 +1,7 @@
 
 import typer
 from typing import Annotated, Literal
+from machineconfig.utils.ssh_utils.abc import MACHINECONFIG_VERSION
 
 
 def copy_both_assets():
@@ -69,12 +70,12 @@ def update(copy_assets: Annotated[bool, typer.Option("--assets-copy/--no-assets-
 uv self update
 cd ~/code/machineconfig
 git pull
-uv tool install --upgrade --editable $HOME/code/machineconfig
+uv tool install --no-cache --upgrade --editable $HOME/code/machineconfig
     """
     else:
         shell_script = """
 uv self update
-uv tool install --upgrade machineconfig
+uv tool install --no-cache --upgrade machineconfig
     """
     import platform
     if platform.system() == "Windows":
@@ -91,41 +92,58 @@ uv tool install --upgrade machineconfig
             copy_both_assets()
         if link_public_configs:
             import machineconfig.profile.create_links_export as create_links_export
-            create_links_export.main_public_from_parser(method="copy", on_conflict="overwrite-default-path", which="all", interactive=False)
+            create_links_export.main_from_parser(sensitivity="public", method="copy", on_conflict="overwrite-default-path", which="all")
 
 
 def install(copy_assets: Annotated[bool, typer.Option("--copy-assets/--no-assets-copy", "-a/-na", help="Copy (overwrite) assets to the machine after the update")] = True,
             dev: Annotated[bool, typer.Option("--dev", "-d", help="Install from local development code instead of PyPI")] = False,
+    
             ):
     """📋 CLONE machienconfig locally and incorporate to shell profile for faster execution and nightly updates."""
-    from machineconfig.utils.code import run_shell_script, get_uv_command
+    from machineconfig.utils.code import run_shell_script, get_uv_command, get_shell_script_running_lambda_function, exit_then_run_shell_script
     from pathlib import Path
     import platform
-    if dev and not Path.home().joinpath("code/machineconfig").exists():
+    mcfg_path = Path.home().joinpath("code/machineconfig")
+    _ = run_shell_script
+    if dev and not mcfg_path.exists():
         # clone: https://github.com/thisismygitrepo/machineconfig.git
         import git
-        repo_parent = Path.home().joinpath("code")
-        repo_parent.mkdir(parents=True, exist_ok=True)
-        git.Repo.clone_from("https://github.com/thisismygitrepo/machineconfig.git", str(repo_parent.joinpath("machineconfig")))
+        mcfg_path.parent.mkdir(parents=True, exist_ok=True)
+        git.Repo.clone_from("https://github.com/thisismygitrepo/machineconfig.git", str(mcfg_path))
+        # now we need to run `uv sync` to install dependencies
+
     uv_command = get_uv_command(platform=platform.system())
-    if Path.home().joinpath("code/machineconfig").exists():
-        run_shell_script(f""" {uv_command} tool install --upgrade --editable "{str(Path.home().joinpath("code/machineconfig"))}" """)
-    else:
-        run_shell_script(rf""" {uv_command} tool install --upgrade "machineconfig>=8.14" """)
     if copy_assets:
-        from machineconfig.profile.create_shell_profile import create_default_shell_profile
-        create_default_shell_profile()   # involves copying assets too
+        def func():
+            from machineconfig.profile.create_shell_profile import create_default_shell_profile
+            create_default_shell_profile()   # involves copying assets too
+        uv_command2, _script_path = get_shell_script_running_lambda_function(lambda: func(),
+                                                          uv_with=["machineconfig"], uv_project_dir=None)
+    else:
+        uv_command2 = ""
+    if mcfg_path.exists():
+        exit_then_run_shell_script(f"""
+cd {str(mcfg_path)}
+{uv_command} sync
+{uv_command} tool install --upgrade --editable "{str(mcfg_path)}"
+{uv_command2}
+""")
+    else:
+        exit_then_run_shell_script(rf"""
+{uv_command} tool install --upgrade "{MACHINECONFIG_VERSION}"
+{uv_command2}
+""")
 
 
 
 def interactive():
     """🤖 INTERACTIVE configuration of machine."""
-    from machineconfig.scripts.python.interactive import main
+    from machineconfig.scripts.python.helpers.helpers_devops.interactive import main
     main()
 
 def status():
     """📊 STATUS of machine, shell profile, apps, symlinks, dotfiles, etc."""
-    import machineconfig.scripts.python.helpers_devops.devops_status as helper
+    import machineconfig.scripts.python.helpers.helpers_devops.devops_status as helper
     helper.main()
 
 
@@ -136,7 +154,7 @@ def navigate():
     path = Path(navigator.__file__).resolve().parent.joinpath("devops_navigator.py")
     from machineconfig.utils.code import exit_then_run_shell_script
     if Path.home().joinpath("code/machineconfig").exists(): executable = f"""--project "{str(Path.home().joinpath("code/machineconfig"))}" --with textual"""
-    else: executable = """--with "machineconfig>=8.14,textual" """
+    else: executable = f"""--with "{MACHINECONFIG_VERSION},textual" """
     exit_then_run_shell_script(f"""uv run {executable} {path}""")
 
 def readme():
@@ -160,21 +178,20 @@ def readme():
 
 
 def get_app():
-    cli_app = typer.Typer(help="🔄 [s] self operations subcommands", no_args_is_help=True, add_help_option=False, add_completion=False)
+    cli_app = typer.Typer(help="🔄 [s] self operations subcommands", no_args_is_help=True, add_help_option=True, add_completion=False)
     cli_app.command("update",      no_args_is_help=False, help="🔄 [u] UPDATE machineconfig")(update)
     cli_app.command("u",           no_args_is_help=False, hidden=True)(update)
-    cli_app.command("interactive", no_args_is_help=False, help="🤖 [i] INTERACTIVE configuration of machine.")(interactive)
-    cli_app.command("i",           no_args_is_help=False, help="INTERACTIVE configuration of machine.", hidden=True)(interactive)
+    cli_app.command("interactive", no_args_is_help=False, help="🤖 [ia] INTERACTIVE configuration of machine.")(interactive)
+    cli_app.command("ia",           no_args_is_help=False, help="INTERACTIVE configuration of machine.", hidden=True)(interactive)
     cli_app.command(name="init",         no_args_is_help=False, help="🦐 [t] Define and manage configurations")(init)
     cli_app.command(name="t",            no_args_is_help=False, hidden=True)(init)
     cli_app.command("status",      no_args_is_help=False, help="📊 [s] STATUS of machine, shell profile, apps, symlinks, dotfiles, etc.")(status)
     cli_app.command("s",           no_args_is_help=False, help="STATUS of machine, shell profile, apps, symlinks, dotfiles, etc.", hidden=True)(status)
-    cli_app.command("install",     no_args_is_help=False, help="📋 [I] CLONE machienconfig locally and incorporate to shell profile for faster execution and nightly updates.")(install)
-    cli_app.command("I",           no_args_is_help=False, help="CLONE machienconfig locally and incorporate to shell profile for faster execution and nightly updates.", hidden=True)(install)
+    cli_app.command("install",     no_args_is_help=False, help="📋 [i] CLONE machienconfig locally and incorporate to shell profile for faster execution and nightly updates.")(install)
+    cli_app.command("i",           no_args_is_help=False, help="CLONE machienconfig locally and incorporate to shell profile for faster execution and nightly updates.", hidden=True)(install)
     cli_app.command("navigate", no_args_is_help=False, help="📚 [n] NAVIGATE command structure with TUI")(navigate)
     cli_app.command("n", no_args_is_help=False, help="NAVIGATE command structure with TUI", hidden=True)(navigate)
 
     cli_app.command("readme", no_args_is_help=False, help="📚 [r] render readme markdown in terminal.")(readme)
     cli_app.command("r", no_args_is_help=False, hidden=True)(readme)
     return cli_app
-

machineconfig/scripts/python/{helpers_devops → helpers/helpers_devops}/cli_share_file.py

@@ -1,6 +1,6 @@
 
 import typer
-from typing import Annotated
+from typing import Annotated, Literal
 
 
 def share_file_receive(code_args: Annotated[list[str], typer.Argument(help="Receive code or relay command. Examples: '7121-donor-olympic-bicycle' or '--relay 10.17.62.206:443 7121-donor-olympic-bicycle'")],
@@ -97,41 +97,55 @@ def share_file_send(path: Annotated[str, typer.Argument(help="Path to the file o
                     code: Annotated[str | None, typer.Option("--code", "-c", help="Codephrase used to connect to relay")] = None,
                     text: Annotated[str | None, typer.Option("--text", "-t", help="Send some text")] = None,
                     qrcode: Annotated[bool, typer.Option("--qrcode", "--qr", help="Show receive code as a qrcode")] = False,
+                    backend: Annotated[Literal["wormhole", "w", "croc", "c"], typer.Option("--backend", "-b", help="Backend to use")] = "croc",
                     ) -> None:
     """Send a file using croc with relay server."""
-    from machineconfig.utils.installer_utils.installer_cli import install_if_missing
-    install_if_missing(which="croc")
-    # Get relay server IP from environment or use default
-    import machineconfig.scripts.python.helpers_network.address as helper
-    res = helper.select_lan_ipv4(prefer_vpn=False)
-    if res is None:
-        typer.echo("❌ Error: Could not determine local LAN IPv4 address for relay.", err=True)
-        raise typer.Exit(code=1)
-    local_ip_v4 = res
     import platform
-    relay_port = "443"
-    is_windows = platform.system() == "Windows"
-
-    # Build command parts
-    relay_arg = f"--relay {local_ip_v4}:{relay_port} --ip {local_ip_v4}:{relay_port}"
-    zip_arg = "--zip" if zip_folder else ""
-    text_arg = f"--text '{text}'" if text else ""
-    qrcode_arg = "--qrcode" if qrcode else ""
-    path_arg = f"{path}" if not text else ""
 
-    if is_windows:
-        # Windows PowerShell format
-        code_arg = f"--code {code}" if code else ""
-        script = f"""croc {relay_arg} send {zip_arg} {code_arg} {qrcode_arg} {text_arg} {path_arg}"""
-    else:
-        # Linux/macOS Bash format
-        if code:
-            script = f"""export CROC_SECRET="{code}"
+    match backend:
+        case "wormhole" | "w":
+            if code is None: code_line = ""
+            else: code_line = f"--code {code}"
+            if text is not None: text_line = f"--text '{text}'"
+            else: text_line = f"'{path}'"
+            script = f"""
+uvx magic-wormhole send {code_line} {text_line}
+"""
+            print(f"🚀 Sending file: {path}. Use: uvx magic-wormhole receive ")
+        case "croc" | "c":
+            from machineconfig.utils.installer_utils.installer_cli import install_if_missing
+            install_if_missing(which="croc")
+
+            # Get relay server IP from environment or use default
+            import machineconfig.scripts.python.helpers.helpers_network.address as helper
+            res = helper.select_lan_ipv4(prefer_vpn=False)
+            if res is None:
+                typer.echo("❌ Error: Could not determine local LAN IPv4 address for relay.", err=True)
+                raise typer.Exit(code=1)
+            local_ip_v4 = res
+            relay_port = "443"
+            is_windows = platform.system() == "Windows"
+            # Build command parts
+            relay_arg = f"--relay {local_ip_v4}:{relay_port} --ip {local_ip_v4}:{relay_port}"
+            zip_arg = "--zip" if zip_folder else ""
+            text_arg = f"--text '{text}'" if text else ""
+            qrcode_arg = "--qrcode" if qrcode else ""
+            path_arg = f"{path}" if not text else ""
+
+            if is_windows:
+                # Windows PowerShell format
+                code_arg = f"--code {code}" if code else ""
+                script = f"""croc {relay_arg} send {zip_arg} {code_arg} {qrcode_arg} {text_arg} {path_arg}"""
+            else:
+                # Linux/macOS Bash format
+                if code:
+                    script = f"""
+export CROC_SECRET="{code}"
 croc {relay_arg} send {zip_arg} {qrcode_arg} {text_arg} {path_arg}"""
-        else:
-            script = f"""croc {relay_arg} send {zip_arg} {qrcode_arg} {text_arg} {path_arg}"""
+                else:
+                    script = f"""croc {relay_arg} send {zip_arg} {qrcode_arg} {text_arg} {path_arg}"""
 
     typer.echo(f"🚀 Sending file: {path}. Use: devops network receive")
     from machineconfig.utils.code import exit_then_run_shell_script, print_code
     print_code(code=script, desc="🚀 sending file with croc", lexer="bash" if platform.system() != "Windows" else "powershell")
-    exit_then_run_shell_script(script=script, strict=False)
+    exit_then_run_shell_script(script=script, strict=False)

machineconfig/scripts/python/{helpers_devops → helpers/helpers_devops}/cli_share_server.py

@@ -1,42 +1,17 @@
 from pathlib import Path
 from typing import Optional, Annotated
-from machineconfig.scripts.python.helpers_devops.cli_share_file import share_file_receive, share_file_send
+from machineconfig.scripts.python.helpers.helpers_devops.cli_share_file import share_file_receive, share_file_send
+from machineconfig.utils.accessories import display_with_flashy_style
 import typer
 
 
-def display_share_url(local_ip_v4: str, port: int, protocol: str = "http") -> None:
-    """Display a flashy, unmissable share URL announcement."""
-    from rich.console import Console
-    from rich.panel import Panel
-    from rich.text import Text
-    from rich.align import Align
-    console = Console()
-    # Create the main message with styling
-    url_text = Text(f"{protocol}://{local_ip_v4}:{port}", style="bold bright_cyan underline")
-    message = Text.assemble(
-        ("🚀 ", "bright_red"),
-        ("Share server is now accessible at: ", "bright_white bold"),
-        url_text,
-        (" 🚀", "bright_red")
-    )
-    # Create a fancy panel with borders and styling
-    panel = Panel(
-        Align.center(message),
-        title="[bold bright_green]🌐 SHARE SERVER READY 🌐[/bold bright_green]",
-        subtitle="[italic bright_yellow]⚡ Click the link above to access your shared files! ⚡[/italic bright_yellow]",
-        border_style="bright_magenta",
-        padding=(1, 2),
-        expand=False
-    )
-    # Print with extra spacing and attention-grabbing elements
-    console.print(panel)
-
-
 def web_file_explorer(
     path: Annotated[str, typer.Argument(help="Path to the file or directory to share")],
     port: Annotated[Optional[int], typer.Option("--port", "-p", help="Port to run the share server on (default: 8080)")] = None,
     username: Annotated[Optional[str], typer.Option("--username", "-u", help="Username for share access (default: current user)")] = None,
+    no_auth: Annotated[bool, typer.Option("--no-auth", "-na", help="Disable authentication for share access")] = False,
     password: Annotated[Optional[str], typer.Option("--password", "-w", help="Password for share access (default: from ~/dotfiles/creds/passwords/quick_password)")] = None,
+    bind_address: Annotated[str, typer.Option("--bind", "-a", help="Address to bind the server to")] = "0.0.0.0",
     over_internet: Annotated[bool, typer.Option("--over-internet", "-i", help="Expose the share server over the internet using ngrok")] = False,
     backend: Annotated[str, typer.Option("--backend", "-b", help="Backend to use: filebrowser (default), miniserve, qrcp, or easy-sharing")] = "miniserve",
 ) -> None:
@@ -48,22 +23,22 @@ def web_file_explorer(
     install_if_missing(which=backend)
     if over_internet:
         install_if_missing(which="ngrok")
-    if username is None:
-        import getpass
-        username = getpass.getuser()
-    
-    if password is None:
+    if password is None and not no_auth:
         pwd_path = Path.home().joinpath("dotfiles/creds/passwords/quick_password")
         if pwd_path.exists():
             password = pwd_path.read_text(encoding="utf-8").strip()
-        else:
-            typer.echo(f"⚠️  WARNING: Password not provided and default password file does not exist.\nPath: {pwd_path}\nUsing default password: 'quick_password' (insecure!)", err=True)
-            raise typer.Exit(code=1)
+            if username is None:
+                import getpass
+                username = getpass.getuser()
+        # else:
+        #     typer.echo(f"⚠️  WARNING: Password not provided and default password file does not exist.\nPath: {pwd_path}\nUsing default password: 'quick_password' (insecure!)", err=True)
+        #     raise typer.Exit(code=1)
+
 
     if port is None:
         port = 8080
 
-    import machineconfig.scripts.python.helpers_network.address as helper
+    import machineconfig.scripts.python.helpers.helpers_network.address as helper
     res = helper.select_lan_ipv4(prefer_vpn=False)
     if res is None:
         typer.echo("❌ ERROR: Could not determine local LAN IPv4 address for share server.", err=True)
@@ -71,7 +46,7 @@ def web_file_explorer(
     local_ip_v4 = res
 
     protocol = "http"
-    display_share_url(local_ip_v4, port, protocol)
+    display_with_flashy_style(msg=f"{protocol}://{local_ip_v4}:{port}/", title="Local Network Share URL")
     
     path_obj = Path(path).resolve()
     if not path_obj.exists():
@@ -83,14 +58,22 @@ def web_file_explorer(
         db_path.parent.mkdir(parents=True, exist_ok=True)
         command = f"""
 filebrowser users add {username} "{password}" --database {db_path}
-filebrowser --address 0.0.0.0 --port {port} --root "{path_obj}" --database {db_path}
+filebrowser --address {bind_address} --port {port} --root "{path_obj}" --database {db_path}
 """
     elif backend == "miniserve":
-        command = f"""miniserve --port {port} --interfaces 0.0.0.0 --auth {username}:{password} --upload-files --mkdir --enable-tar --enable-tar-gz --enable-zip --qrcode "{path_obj}" """
+        if username and password:
+            auth_line = f"""--auth "{username}:{password}" """
+        else:
+            auth_line = ""
+        command = f"""miniserve --port {port} --interfaces {bind_address} {auth_line} --upload-files --mkdir --enable-tar --enable-tar-gz --enable-zip --qrcode "{path_obj}" """
     elif backend == "easy-sharing":
-        command = f"""easy-sharing --port {port} --username {username} --password "{password}" "{path_obj}" """
+        if username is None and password is None:
+            auth_line = ""
+        else:
+            auth_line = f'--username "{username}" --password "{password}"'
+        command = f"""easy-sharing --port {port} {auth_line} "{path_obj}" """
     elif backend == "qrcp":
-        command = f"""qrcp "{path_obj}" """
+        command = f"""qrcp --port {port} --bind {bind_address} "{path_obj}" """
     else:
         typer.echo(f"❌ ERROR: Unknown backend '{backend}'", err=True)
         raise typer.Exit(code=1)

machineconfig/scripts/python/{helpers_devops → helpers/helpers_devops}/cli_share_terminal.py

@@ -46,6 +46,7 @@ def share_terminal(
     port: Annotated[Optional[int], typer.Option("--port", "-p", help="Port to run the terminal server on (default: 7681)")] = None,
     username: Annotated[Optional[str], typer.Option("--username", "-u", help="Username for terminal access (default: current user)")] = None,
     password: Annotated[Optional[str], typer.Option("--password", "-w", help="Password for terminal access (default: from ~/dotfiles/creds/passwords/quick_password)")] = None,
+    no_auth: Annotated[bool, typer.Option("--no-auth", "-n", help="Disable authentication (not recommended)")] = False,
     start_command: Annotated[Optional[str], typer.Option("--start-command", "-s", help="Command to run on terminal start (default: bash/powershell)")] = None,
     ssl: Annotated[bool, typer.Option("--ssl", "-S", help="Enable SSL")] = False,
     ssl_cert: Annotated[Optional[str], typer.Option("--ssl-cert", "-C", help="SSL certificate file path")] = None,
@@ -61,12 +62,14 @@ def share_terminal(
     if username is None:
         import getpass
         username = getpass.getuser()
-    if password is None:
+    if password is None and not no_auth:
         pwd_path = Path.home().joinpath("dotfiles/creds/passwords/quick_password")
         if pwd_path.exists():
             password = pwd_path.read_text(encoding="utf-8").strip()
         else:
-            raise ValueError("Password not provided and default password file does not exist.")
+            # raise ValueError("Password not provided and default password file does not exist.")
+            print("❌ Error: Password not provided and default password file does not exist.")
+            raise typer.Exit(code=1)
 
     if port is None:
         port = 7681  # Default port for ttyd
@@ -83,14 +86,17 @@ def share_terminal(
         key_path = Path(ssl_key)
         
         if not cert_path.exists():
-            raise FileNotFoundError(f"SSL certificate file not found: {ssl_cert}")
+            print(f"❌ Error: SSL certificate file not found: {ssl_cert}")
+            raise typer.Exit(code=1)
         if not key_path.exists():
-            raise FileNotFoundError(f"SSL key file not found: {ssl_key}")
+            print(f"❌ Error: SSL key file not found: {ssl_key}")
+            raise typer.Exit(code=1)
         
         if ssl_ca and not Path(ssl_ca).exists():
-            raise FileNotFoundError(f"SSL CA file not found: {ssl_ca}")
+            print(f"❌ Error: SSL CA file not found: {ssl_ca}")
+            raise typer.Exit(code=1)
 
-    import machineconfig.scripts.python.helpers_network.address as helper
+    import machineconfig.scripts.python.helpers.helpers_network.address as helper
     res = helper.select_lan_ipv4(prefer_vpn=False)
     if res is None:
         print("❌ Error: Could not determine local LAN IPv4 address for terminal.")

machineconfig/scripts/python/helpers/helpers_devops/cli_ssh.py

@@ -0,0 +1,167 @@
+import typer
+from typing import Optional, Annotated
+
+
+def install_ssh_server() -> None:
+    """📡 Install SSH server"""
+    import platform
+    if platform.system() == "Windows":
+        script = _get_windows_ssh_server_install_script()
+    elif platform.system() == "Linux" or platform.system() == "Darwin":
+        script = """
+sudo nala install openssh-server -y || true  # try to install first
+# sudo nala purge openssh-server -y
+# sudo nala install openssh-server -y
+echo "✅ FINISHED installing openssh-server."
+"""
+    else:
+        print(f"❌ Error: Platform {platform.system()} is not supported.")
+        raise typer.Exit(code=1)
+    from machineconfig.utils.code import run_shell_script
+    run_shell_script(script=script)
+
+
+def change_ssh_port(port: Annotated[int, typer.Option(..., "--port", "-p", help="SSH port to use")] = 2222) -> None:
+    """🔌 Change SSH port (Linux/WSL only, default: 2222)"""
+    import platform
+    if platform.system() != "Linux":
+        print("❌ Error: change_ssh_port requires Linux environment")
+        raise typer.Exit(code=1)
+    from machineconfig.utils.ssh_utils.wsl import change_ssh_port as _change_ssh_port
+    _change_ssh_port(port=port)
+
+
+def _get_windows_ssh_server_install_script(use_winget: bool = True) -> str:
+    install_winget = r'''
+    Write-Host "Installing OpenSSH via winget..." -ForegroundColor Cyan
+    winget install --no-upgrade --Id Microsoft.OpenSSH.Preview --source winget --accept-package-agreements --accept-source-agreements
+    $wingetSshPath = "C:\Program Files\OpenSSH"
+    $currentMachinePath = [System.Environment]::GetEnvironmentVariable("Path", "Machine")
+    if ($currentMachinePath -notlike "*$wingetSshPath*") {
+        Write-Host "Adding OpenSSH to system PATH..." -ForegroundColor Yellow
+        [System.Environment]::SetEnvironmentVariable("Path", "$currentMachinePath;$wingetSshPath", "Machine")
+    }
+    $env:Path = [System.Environment]::GetEnvironmentVariable("Path", "Machine") + ";" + [System.Environment]::GetEnvironmentVariable("Path", "User")
+'''
+    install_capability = r'''
+    Write-Host "Installing OpenSSH via Windows Capability..." -ForegroundColor Cyan
+    Add-WindowsCapability -Online -Name OpenSSH.Server
+    Add-WindowsCapability -Online -Name OpenSSH.Client
+    $env:Path = [System.Environment]::GetEnvironmentVariable("Path", "Machine") + ";" + [System.Environment]::GetEnvironmentVariable("Path", "User")
+'''
+    configure_sshd_service = r'''
+    $serviceExists = Get-Service -Name sshd -ErrorAction SilentlyContinue
+    if (-not $serviceExists) {
+        Write-Host "sshd service not found, registering manually..." -ForegroundColor Yellow
+        sc.exe create sshd binPath= "$sshdExePath" start= auto
+        if ($LASTEXITCODE -ne 0) { throw "Failed to create sshd service" }
+    }
+    Set-Service -Name sshd -StartupType Automatic
+    Start-Service sshd
+    Write-Host "sshd service started successfully." -ForegroundColor Green
+'''
+    configure_firewall = r'''
+    $existingRule = Get-NetFirewallRule -Name "OpenSSH-Server-In-TCP" -ErrorAction SilentlyContinue
+    if (-not $existingRule) {
+        Write-Host "Creating firewall rule for SSH..." -ForegroundColor Yellow
+        New-NetFirewallRule -Name "OpenSSH-Server-In-TCP" -DisplayName "OpenSSH SSH Server" -Enabled True -Direction Inbound -Protocol TCP -Action Allow -LocalPort 22 -Program $sshdExePath
+    } else {
+        Write-Host "Firewall rule already exists." -ForegroundColor Green
+    }
+'''
+    configure_default_shell = r'''
+    Write-Host "Configuring default shell for SSH..." -ForegroundColor Cyan
+    $shell = "C:\Windows\System32\WindowsPowerShell\v1.0\powershell.exe"
+    if (-not (Test-Path "HKLM:\SOFTWARE\OpenSSH")) { New-Item -Path "HKLM:\SOFTWARE\OpenSSH" -Force | Out-Null }
+    New-ItemProperty -Path "HKLM:\SOFTWARE\OpenSSH" -Name DefaultShell -Value $shell -PropertyType String -Force | Out-Null
+    New-ItemProperty -Path "HKLM:\SOFTWARE\OpenSSH" -Name DefaultShellCommandOption -Value "/c" -PropertyType String -Force | Out-Null
+    Write-Host "Default shell set to: $shell" -ForegroundColor Green
+'''
+    configure_ssh_agent = r'''
+    Write-Host "Configuring ssh-agent service..." -ForegroundColor Cyan
+    $agentService = Get-Service -Name ssh-agent -ErrorAction SilentlyContinue
+    if ($agentService) {
+        Set-Service -Name ssh-agent -StartupType Automatic
+        Start-Service ssh-agent -ErrorAction SilentlyContinue
+        Write-Host "ssh-agent service configured and started." -ForegroundColor Green
+    } else {
+        Write-Host "ssh-agent service not available." -ForegroundColor Yellow
+    }
+'''
+    ensure_ssh_directory = r'''
+    $sshDir = Join-Path $env:USERPROFILE ".ssh"
+    if (-not (Test-Path $sshDir)) {
+        New-Item -ItemType Directory -Path $sshDir -Force | Out-Null
+        Write-Host "Created .ssh directory at: $sshDir" -ForegroundColor Green
+    }
+'''
+    if use_winget:
+        install_method = install_winget
+        sshd_exe_path = r'C:\Program Files\OpenSSH\sshd.exe'
+    else:
+        install_method = install_capability
+        sshd_exe_path = r'$env:WINDIR\System32\OpenSSH\sshd.exe'
+    return fr'''
+$ErrorActionPreference = "Stop"
+try {{ Set-ExecutionPolicy -Scope CurrentUser Bypass -ErrorAction SilentlyContinue }} catch {{ }}
+Write-Host "========================================" -ForegroundColor Magenta
+Write-Host "OpenSSH Server Installation for Windows" -ForegroundColor Magenta
+Write-Host "========================================" -ForegroundColor Magenta
+{install_method}
+$sshdExePath = "{sshd_exe_path}"
+{configure_sshd_service}
+{configure_firewall}
+{configure_default_shell}
+{configure_ssh_agent}
+{ensure_ssh_directory}
+Write-Host "========================================" -ForegroundColor Magenta
+Write-Host "OpenSSH Server installation complete!" -ForegroundColor Green
+Write-Host "SSH config directory: $env:ProgramData\ssh" -ForegroundColor Cyan
+Write-Host "========================================" -ForegroundColor Magenta
+'''
+
+
+def add_ssh_key(
+    path: Annotated[Optional[str], typer.Option(..., help="Path to the public key file")] = None,
+    choose: Annotated[bool, typer.Option(..., "--choose", "-c", help="Choose from available public keys in ~/.ssh/*.pub")] = False,
+    value: Annotated[bool, typer.Option(..., "--value", "-v", help="Paste the public key content manually")] = False,
+    github: Annotated[Optional[str], typer.Option(..., "--github", "-g", help="Fetch public keys from a GitHub username")] = None,
+) -> None:
+    """🔑 Add SSH public key to this machine so its accessible by owner of corresponding private key."""
+    import machineconfig.scripts.python.helpers.helpers_network.ssh_add_ssh_key as helper
+    helper.main(pub_path=path, pub_choose=choose, pub_val=value, from_github=github)
+
+
+def add_ssh_identity() -> None:
+    """🗝️ Add SSH identity (private key) to this machine"""
+    import machineconfig.scripts.python.helpers.helpers_network.ssh_add_identity as helper
+    helper.main()
+
+
+def debug_ssh() -> None:
+    """🐛 Debug SSH connection"""
+    from platform import system
+    if system() == "Linux" or system() == "Darwin":
+        import machineconfig.scripts.python.helpers.helpers_network.ssh_debug_linux as helper
+        helper.ssh_debug_linux()
+    elif system() == "Windows":
+        import machineconfig.scripts.python.helpers.helpers_network.ssh_debug_windows as helper
+        helper.ssh_debug_windows()
+    else:
+        print(f"❌ Error: Platform {system()} is not supported.")
+        raise typer.Exit(code=1)
+
+
+def get_app() -> typer.Typer:
+    ssh_app = typer.Typer(help="🔐 SSH subcommands", no_args_is_help=True, add_help_option=True, add_completion=False)
+    ssh_app.command(name="install-server", help="📡 [i] Install SSH server")(install_ssh_server)
+    ssh_app.command(name="i", help="Install SSH server", hidden=True)(install_ssh_server)
+    ssh_app.command(name="change-port", help="🔌 [p] Change SSH port (Linux/WSL only)")(change_ssh_port)
+    ssh_app.command(name="p", help="Change SSH port", hidden=True)(change_ssh_port)
+    ssh_app.command(name="add-key", help="🔑 [k] Add SSH public key to this machine", no_args_is_help=True)(add_ssh_key)
+    ssh_app.command(name="k", help="Add SSH public key to this machine", hidden=True, no_args_is_help=True)(add_ssh_key)
+    ssh_app.command(name="add-identity", help="🗝️ [A] Add SSH identity (private key) to this machine")(add_ssh_identity)
+    ssh_app.command(name="A", help="Add SSH identity (private key) to this machine", hidden=True)(add_ssh_identity)
+    ssh_app.command(name="debug", help="🐛 [d] Debug SSH connection")(debug_ssh)
+    ssh_app.command(name="d", help="Debug SSH connection", hidden=True)(debug_ssh)
+    return ssh_app

machineconfig/scripts/python/{helpers_devops → helpers/helpers_devops}/devops_status.py

@@ -11,7 +11,7 @@ from rich.table import Table
 from rich.text import Text
 
 from machineconfig.utils.path_extended import PathExtended
-from machineconfig.utils.source_of_truth import CONFIG_ROOT, DEFAULTS_PATH, LIBRARY_ROOT
+from machineconfig.utils.source_of_truth import CONFIG_ROOT, DEFAULTS_PATH
 
 
 console = Console()
@@ -137,7 +137,7 @@ def _check_config_files_status() -> dict[str, Any]:
     from machineconfig.profile.create_links import read_mapper
 
     try:
-        mapper = read_mapper()
+        mapper = read_mapper(repo="library")
         public_configs = list(mapper.get("public", {}).keys())
         private_configs = list(mapper.get("private", {}).keys())
 
@@ -205,10 +205,16 @@ def _check_backup_config() -> dict[str, Any]:
         cloud_config = "Not configured"
 
     try:
-        backup_file = LIBRARY_ROOT.joinpath("profile/backup.toml")
+        from machineconfig.scripts.python.helpers.helpers_devops.backup_config import LIBRARY_BACKUP_PATH
+        backup_file = LIBRARY_BACKUP_PATH
         if backup_file.exists():
             backup_data = tomllib.loads(backup_file.read_text(encoding="utf-8"))
-            backup_items = list(backup_data.keys())
+            backup_items: list[str] = []
+            for group_name, entries in backup_data.items():
+                if isinstance(entries, dict):
+                    backup_items.extend([f"{group_name}.{entry_name}" for entry_name in entries.keys()])
+                else:
+                    backup_items.append(str(group_name))
             backup_items_count = len(backup_items)
         else:
             backup_items = []
@@ -466,8 +472,8 @@ def main() -> None:
     console.print("\n")
     
     # system_info = _check_system_info()
-    # from machineconfig.scripts.python.helpers_devops.devops_system_info import _check_system_info
-    from machineconfig.scripts.python.helpers_utils.python import get_machine_specs
+    # from machineconfig.scripts.python.helpers.helpers_devops.devops_system_info import _check_system_info
+    from machineconfig.scripts.python.helpers.helpers_utils.python import get_machine_specs
     system_info = get_machine_specs()
     from typing import cast
     system_info = cast(dict[str, str], system_info)

machineconfig/scripts/python/{helpers_devops → helpers/helpers_devops}/devops_update_repos.py

@@ -9,7 +9,7 @@ from rich.panel import Panel
 from rich.table import Table
 from rich.text import Text
 
-from machineconfig.scripts.python.helpers_repos.update import RepositoryUpdateResult, run_uv_sync, update_repository
+from machineconfig.scripts.python.helpers.helpers_repos.update import RepositoryUpdateResult, run_uv_sync, update_repository
 from machineconfig.utils.io import read_ini
 from machineconfig.utils.source_of_truth import DEFAULTS_PATH