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

machineconfig/scripts/python/{helpers_repos → helpers/helpers_repos}/cloud_repo_sync.py

@@ -1,7 +1,22 @@
 
-from typing import Optional, Literal, Annotated
 
+from typing import Optional, Literal, Annotated
 import typer
+from machineconfig.utils.ssh_utils.abc import MACHINECONFIG_VERSION
+
+
+def get_tmp_file():
+    from pathlib import Path
+    import platform
+    from machineconfig.utils.accessories import randstr
+    name = randstr(8)
+    if platform.system() == "Windows":
+        suffix = "ps1"
+    else:
+        suffix = "sh"
+    tmp_file = Path.home().joinpath(f"tmp_results/tmp_files/{name}.{suffix}")
+    tmp_file.parent.mkdir(parents=True, exist_ok=True)
+    return tmp_file
 
 
 def main(
@@ -29,6 +44,7 @@ def main(
         "remove-rclone-conflict": "remove-rclone-conflict",
     }
     on_conflict = on_conflict_mapper[on_conflict]
+    import platform
     import git
     from rich.console import Console
     from rich.panel import Panel
@@ -38,10 +54,15 @@ def main(
     from machineconfig.utils.source_of_truth import CONFIG_ROOT, DEFAULTS_PATH
     from machineconfig.utils.code import get_uv_command_executing_python_script
     from pathlib import Path
-    import platform
     import subprocess
     console = Console()
 
+    def _bash_single_quote(val: str) -> str:
+        return "'" + val.replace("'", "'\"'\"'") + "'"
+
+    def _ps_single_quote(val: str) -> str:
+        return "'" + val.replace("'", "''") + "'"
+
     if cloud is None:
         try:
             from machineconfig.utils.io import read_ini
@@ -57,7 +78,8 @@ def main(
     try:
         repo_local_obj = git.Repo(repo_local_root, search_parent_directories=True)
     except git.InvalidGitRepositoryError:
-        typer.echo(f"[red]Error:[/] The specified path '{repo_local_root}' is not a valid git repository.")
+        msg = typer.style("Error: ", fg=typer.colors.RED) + f"The specified path '{repo_local_root}' is not a valid git repository."
+        typer.echo(msg)
         typer.Exit(code=1)
         return ""
     repo_local_root = PathExtended(repo_local_obj.working_dir)  # cwd might have been in a sub directory of repo_root, so its better to redefine it.
@@ -80,43 +102,89 @@ def main(
     if repo_remote_obj.is_dirty():
         console.print(Panel(f"⚠️  WARNING: REMOTE REPOSITORY IS DIRTY\nLocation: {repo_remote_root}\nPlease commit or stash changes before proceeding.", title="Warning", border_style="yellow"))
 
-    script = f"""
+    message_resolved = "sync" if message is None or message.strip() == "" else message
+
+    repo_local_root_str = str(repo_local_root)
+    repo_remote_root_str = str(repo_remote_root)
+
+    script_bash = f"""
 echo ""
-echo 'echo -e "\\033[1;34m═════ COMMITTING LOCAL CHANGES ═════\\033[0m"'
-cd {repo_local_root}
+echo -e "\\033[1;34m═════ COMMITTING LOCAL CHANGES ═════\\033[0m"
+cd {_bash_single_quote(repo_local_root_str)}
 git status
-git add .
-git commit -am "{message}"
+git add -A
+if git diff --cached --quiet; then
+  echo "-> No staged changes to commit."
+else
+  git commit -m {_bash_single_quote(message_resolved)} || true
+fi
 echo ""
 echo ""
-echo 'echo -e "\\033[1;34m═════ PULLING LATEST FROM REMOTE ═════\\033[0m"'
-cd {repo_local_root}
-echo '-> Trying to removing originEnc remote from local repo if it exists.'
-# git remote remove originEnc
+echo -e "\\033[1;34m═════ PULLING LATEST FROM REMOTE ═════\\033[0m"
+cd {_bash_single_quote(repo_local_root_str)}
+echo "-> Trying to removing originEnc remote from local repo if it exists."
 git remote remove originEnc 2>/dev/null || true
-echo '-> Adding originEnc remote to local repo'
-git remote add originEnc {repo_remote_root}
-echo '-> Fetching originEnc remote.'
+echo "-> Adding originEnc remote to local repo"
+git remote add originEnc {_bash_single_quote(repo_remote_root_str)}
+echo "-> Fetching originEnc remote."
 git pull originEnc master
 
 """
 
+    script_powershell = f"""
+Write-Host ""
+Write-Host "═════ COMMITTING LOCAL CHANGES ═════" -ForegroundColor Blue
+Set-Location -LiteralPath {_ps_single_quote(repo_local_root_str)}
+git status
+git add -A
+git diff --cached --quiet
+if ($LASTEXITCODE -eq 0) {{
+    Write-Host "-> No staged changes to commit."
+}} else {{
+    git commit -m {_ps_single_quote(message_resolved)}
+    if ($LASTEXITCODE -ne 0) {{
+        Write-Host "-> Commit skipped/failed (continuing)."
+    }}
+}}
+
+Write-Host ""
+Write-Host ""
+Write-Host "═════ PULLING LATEST FROM REMOTE ═════" -ForegroundColor Blue
+Set-Location -LiteralPath {_ps_single_quote(repo_local_root_str)}
+Write-Host "-> Trying to remove originEnc remote from local repo if it exists."
+git remote remove originEnc 2>$null
+Write-Host "-> Adding originEnc remote to local repo"
+git remote add originEnc {_ps_single_quote(repo_remote_root_str)}
+Write-Host "-> Fetching originEnc remote."
+git pull originEnc master
+exit $LASTEXITCODE
+"""
+
+    script = script_powershell if platform.system() == "Windows" else script_bash
+
     if Path.home().joinpath("code/machineconfig").exists():
         uv_project_dir = f"""{str(Path.home().joinpath("code/machineconfig"))}"""
         uv_with = None
     else:
-        uv_with = ["machineconfig>=8.14"]
+        uv_with = [MACHINECONFIG_VERSION]
         uv_project_dir = None
 
-    import tempfile
-    shell_path = Path(tempfile.mkstemp(suffix=".ps1" if platform.system() == "Windows" else ".sh")[1])
+    shell_path = get_tmp_file()
     shell_path.write_text(script, encoding="utf-8")
-
-    command = f". {shell_path}"
     if platform.system() == "Windows":
-        completed = subprocess.run(["powershell", "-Command", command], capture_output=True, check=False, text=True)
+        completed = subprocess.run(
+            ["powershell", "-ExecutionPolicy", "Bypass", "-File", str(shell_path)],
+            capture_output=True,
+            check=False,
+            text=True,
+        )
     else:
-        completed = subprocess.run(command, shell=True, capture_output=True, check=False, text=True)
+        completed = subprocess.run(
+            ["bash", str(shell_path)],
+            capture_output=True,
+            check=False,
+            text=True,
+        )
     res = Response.from_completed_process(completed).capture().print()
 
     if res.is_successful(strict_err=True, strict_returcode=True):
@@ -134,31 +202,37 @@ git pull originEnc master
         option1 = "Delete remote copy and push local:"
         from machineconfig.utils.meta import lambda_to_python_script
         def func2(remote_repo: str, local_repo: str, cloud: str):
-            from machineconfig.scripts.python.helpers_repos.sync import delete_remote_repo_copy_and_push_local
+            from machineconfig.scripts.python.helpers.helpers_repos.sync import delete_remote_repo_copy_and_push_local
             delete_remote_repo_copy_and_push_local(remote_repo=remote_repo, local_repo=local_repo, cloud=cloud)
         program_1_py = lambda_to_python_script(lambda: func2(remote_repo=str(repo_remote_root), local_repo=str(repo_local_root), cloud=str(cloud_resolved)),
                                                         in_global=True, import_module=False)
         program1, _pyfile1 = get_uv_command_executing_python_script(python_script=program_1_py, uv_with=uv_with, uv_project_dir=uv_project_dir)
         # ================================================================================
+
         option2 = "Delete local repo and replace it with remote copy:"
-        program_2 = f"""
-rm -rfd {repo_local_root}
-mv {repo_remote_root} {repo_local_root}
-"""
+        if platform.system() == "Windows":
+            program_2 = f"""
+Remove-Item -LiteralPath {_ps_single_quote(repo_local_root_str)} -Recurse -Force -ErrorAction SilentlyContinue
+Move-Item -LiteralPath {_ps_single_quote(repo_remote_root_str)} -Destination {_ps_single_quote(repo_local_root_str)} -Force
+    """
+        else:
+            program_2 = f"""
+rm -rfd {_bash_single_quote(repo_local_root_str)}
+mv {_bash_single_quote(repo_remote_root_str)} {_bash_single_quote(repo_local_root_str)}
+    """
         if platform.system() in ["Linux", "Darwin"]:
             program_2 += """
 sudo chmod 600 $HOME/.ssh/*
 sudo chmod 700 $HOME/.ssh
 sudo chmod +x $HOME/dotfiles/scripts/linux -R
 """
-        import tempfile
-        shell_file_2 = Path(tempfile.mkstemp(suffix=".ps1" if platform.system() == "Windows" else ".sh")[1])
+        shell_file_2 = get_tmp_file()
         shell_file_2.write_text(program_2, encoding="utf-8")
 
         # ================================================================================
         option3 = "Inspect repos:"
         def func(repo_local_root: str, repo_remote_root: str):
-            from machineconfig.scripts.python.helpers_repos.sync import inspect_repos
+            from machineconfig.scripts.python.helpers.helpers_repos.sync import inspect_repos
             inspect_repos(repo_local_root=repo_local_root, repo_remote_root=repo_remote_root)
         # program_3_py = function_to_script(func=func, call_with_kwargs={"repo_local_root": str(repo_local_root), "repo_remote_root": str(repo_remote_root)})
         # shell_file_3 = get_shell_file_executing_python_script(python_script=program_3_py, ve_path=None, executable=executable)
@@ -168,14 +242,24 @@ sudo chmod +x $HOME/dotfiles/scripts/linux -R
         # ================================================================================
 
         option4 = "Remove problematic rclone file from repo and replace with remote:"
-        program_4 = f"""
+        if platform.system() == "Windows":
+            program_4 = f"""
+Remove-Item -LiteralPath "$HOME/dotfiles/creds/rclone/rclone.conf" -Force -ErrorAction SilentlyContinue
+New-Item -ItemType Directory -Path "$HOME/dotfiles/creds/rclone" -Force | Out-Null
+Copy-Item -LiteralPath "$HOME/.config/machineconfig/remote/dotfiles/creds/rclone/rclone.conf" -Destination "$HOME/dotfiles/creds/rclone/rclone.conf" -Force
+Set-Location -LiteralPath "$HOME/dotfiles"
+git commit -am "finished merging"
+{program1}
+    """
+        else:
+            program_4 = f"""
 rm $HOME/dotfiles/creds/rclone/rclone.conf
 cp $HOME/.config/machineconfig/remote/dotfiles/creds/rclone/rclone.conf $HOME/dotfiles/creds/rclone
 cd $HOME/dotfiles
 git commit -am "finished merging"
 {program1}
-"""
-        shell_file_4 = Path(tempfile.mkstemp(suffix=".ps1" if platform.system() == "Windows" else ".sh")[1])
+    """
+        shell_file_4 = get_tmp_file()
         shell_file_4.write_text(program_4, encoding="utf-8")
         # ================================================================================
 

machineconfig/scripts/python/{helpers_repos → helpers/helpers_repos}/grource.py

@@ -169,7 +169,7 @@ def visualize(
         if platform.system() == "Windows":
             print(f"⚠️  Portable gource not found at {gource_exe}, installing...")
             install_gource_windows()
-            # Check again after installation
+            gource_exe = get_gource_executable()  # Re-fetch path after installation
             if gource_exe.exists():
                 print(f"✅ Gource installed successfully at: {gource_exe}")
                 gource_cmd: str = str(gource_exe)
@@ -177,7 +177,8 @@ def visualize(
                 print("❌ Installation failed, falling back to system gource")
                 raise typer.Exit(1)
         else:
-            raise FileNotFoundError(f"Gource executable not found at {gource_exe}. Please install gource using your package manager.")
+            print(f"❌ Error: Gource executable not found at {gource_exe}. Please install gource using your package manager.")
+            raise typer.Exit(1)
     else:
         gource_cmd = str(gource_exe)
 

machineconfig/scripts/python/{helpers_repos → helpers/helpers_repos}/record.py

@@ -3,7 +3,6 @@ from pathlib import Path
 from machineconfig.utils.schemas.repos.repos_types import GitVersionInfo, RepoRecordDict, RepoRemote
 
 from machineconfig.utils.schemas.repos.repos_types import RepoRecordFile
-from machineconfig.utils.source_of_truth import CONFIG_ROOT
 from machineconfig.utils.io import save_json
 
 from typing import Optional
@@ -12,7 +11,7 @@ from rich import print as pprint
 from rich.progress import Progress, TaskID, SpinnerColumn, TextColumn, BarColumn, TimeElapsedColumn, MofNCompleteColumn
 
 
-def build_tree_structure(repos: list[RepoRecordDict], repos_root: PathExtended) -> str:
+def build_tree_structure(repos: list[RepoRecordDict], repos_root: Path) -> str:
     """Build a tree structure representation of all repositories."""
     if not repos:
         return "No repositories found."
@@ -186,10 +185,18 @@ def record_repos_recursively(repos_root: str, r: bool, progress: Progress | None
     return res
 
 
-def main_record(repos_root: Path):
-    print("\n📝 Recording repositories...")
-    repos_root = PathExtended(repos_root).expanduser().absolute()
+def _resolve_directory(directory: Optional[str]) -> Path:
+    import typer
+    if directory is None:
+        directory = Path.cwd().as_posix()
+        typer.echo(f"📁 Using directory: {directory}")
+    return Path(directory).expanduser().absolute().resolve()
+
 
+def main_record(repos_root_str: Optional[str]) -> Path:
+    print("\n📝 Recording repositories...")
+    repos_root = _resolve_directory(directory=repos_root_str)
+    
     # Count total directories and repositories for accurate progress tracking
     print("🔍 Analyzing directory structure...")
     total_dirs = count_total_directories(str(repos_root), r=True)
@@ -222,7 +229,7 @@ def main_record(repos_root: Path):
     if repos_with_no_remotes:
         print(f"\n⚠️  WARNING: {len(repos_with_no_remotes)} repositories have no remotes configured:")
         for repo in repos_with_no_remotes:
-            repo_path = PathExtended(repo["parentDir"]).joinpath(repo["name"])
+            repo_path = Path(repo["parentDir"]).joinpath(repo["name"])
             print(f"   • {repo['name']} ({repo_path})")
         print("   These repositories may be local-only or have configuration issues.")
     else:
@@ -231,7 +238,7 @@ def main_record(repos_root: Path):
     if dirty_repos:
         print(f"\n⚠️  WARNING: {len(dirty_repos)} repositories have uncommitted changes:")
         for repo in dirty_repos:
-            repo_path = PathExtended(repo["parentDir"]).joinpath(repo["name"])
+            repo_path = Path(repo["parentDir"]).joinpath(repo["name"])
             print(f"   • {repo['name']} ({repo_path}) [branch: {repo['currentBranch']}]")
         print("   These repositories have uncommitted changes that may need attention.")
     else:
@@ -239,12 +246,25 @@ def main_record(repos_root: Path):
 
     # Display repository tree structure
     print("\n🌳 Repository Tree Structure:")
-    tree_structure = build_tree_structure(repo_records, repos_root)
+    tree_structure = build_tree_structure(repos=repo_records, repos_root=repos_root)
     print(tree_structure)
 
-    relative_repos_root = PathExtended(repos_root).expanduser().absolute().relative_to(Path.home())
-    save_path = CONFIG_ROOT.joinpath("repos").joinpath(relative_repos_root).joinpath("repos.json")
-    save_json(obj=res, path=save_path, indent=4)
-    pprint(f"📁 Result saved at {PathExtended(save_path)}")
+    spec_path_default = Path(repos_root).expanduser().absolute().joinpath("repos.json")
+    from machineconfig.scripts.python.helpers.helpers_devops.cli_config_dotfile import get_backup_path, record_mapping
+    spec_path_self_managed = get_backup_path(
+        orig_path=spec_path_default,
+        sensitivity="private",
+        destination=None,
+        shared=False,
+    )
+    save_json(obj=res, path=spec_path_self_managed, indent=4)
+    pprint(f"📁 Result saved at {PathExtended(spec_path_self_managed)}")
+
+    # record_mapping(
+    #     orig_path=spec_path_default,
+
+    # )
+    _ = record_mapping
+
     print(">>>>>>>>> Finished Recording")
-    return save_path
+    return spec_path_self_managed

machineconfig/scripts/python/{helpers_repos → helpers/helpers_repos}/repo_analyzer_2.py

@@ -1,13 +1,23 @@
 from git import Repo
-from machineconfig.scripts.python.helpers_repos.repo_analyzer_1 import count_python_lines, get_default_branch
+from machineconfig.scripts.python.helpers.helpers_repos.repo_analyzer_1 import count_python_lines, get_default_branch
 from datetime import datetime
 import polars as pl
 from pathlib import Path
-from typing import Any, Dict, List, Union, Optional
+from typing import cast, TypedDict
 
 
-def print_python_files_by_size_impl(repo_path: str) -> "Union[pl.DataFrame, Exception]":
-    import polars as pl
+class FileDataRow(TypedDict):
+    filename: str
+    lines: int
+
+
+class CommitDataRow(TypedDict):
+    hash: str
+    dtmExit: datetime
+    lines: int
+
+
+def print_python_files_by_size_impl(repo_path: str) -> pl.DataFrame | Exception:
     import plotly.graph_objects as go
     import plotly.express as px
 
@@ -16,7 +26,7 @@ def print_python_files_by_size_impl(repo_path: str) -> "Union[pl.DataFrame, Exce
         if not os.path.exists(repo_path):
             return ValueError(f"Repository path does not exist: {repo_path}")
         # Initialize data storage
-        file_data: "List[Dict[str, Union[str, int]]]" = []
+        file_data: list[FileDataRow] = []
 
         # Walk through the repository
         for root, _, files in os.walk(repo_path):
@@ -66,7 +76,8 @@ def print_python_files_by_size_impl(repo_path: str) -> "Union[pl.DataFrame, Exce
         table.add_column("Lines", justify="right")
 
         for idx, row in enumerate(df.iter_rows(named=True), 1):
-            table.add_row(str(idx), row["filename"], f"{row['lines']:,}")
+            typed_row = cast(FileDataRow, row)
+            table.add_row(str(idx), typed_row["filename"], f"{typed_row['lines']:,}")
 
         console.print(table)
         print(f"\n📁 Total Python files: {file_count}")
@@ -118,7 +129,7 @@ def print_python_files_by_size_impl(repo_path: str) -> "Union[pl.DataFrame, Exce
         )
 
         # Define pie chart figure before conditionally using it
-        fig2: "Optional[go.Figure]" = None
+        fig2: go.Figure | None = None
 
         # Add pie chart showing distribution
         if len(df) > top_n:
@@ -175,14 +186,15 @@ def analyze_over_time(repo_path: str):
     repo: Repo = Repo(repo_path)
     branch_name: str = get_default_branch(repo)
     print(f"🔍 Using branch: {branch_name}")
-    commit_data: "List[Dict[str, Any]]" = []
+    commit_data: list[CommitDataRow] = []
     print("⏳ Analyzing commits...")
     try:
         commits = list(repo.iter_commits(branch_name))
         from datetime import timezone
         from rich.progress import track
         for commit in track(commits, description="Processing commits..."):
-            commit_data.append({"hash": commit.hexsha, "dtmExit": datetime.fromtimestamp(commit.committed_date, tz=timezone.utc), "lines": count_python_lines(commit)})
+            lines, _files = count_python_lines(commit)
+            commit_data.append({"hash": commit.hexsha, "dtmExit": datetime.fromtimestamp(commit.committed_date, tz=timezone.utc), "lines": lines})
     except Exception as e:
         print(f"❌ Error analyzing commits: {str(e)}")
         return
@@ -199,20 +211,50 @@ def analyze_over_time(repo_path: str):
     # Add markers for significant points (min, max, last)
     min_idx = df["lines"].arg_min()
     max_idx = df["lines"].arg_max()
-    min_point = df.slice(min_idx, 1).to_dicts()[0] if min_idx is not None else {}
-    max_point = df.slice(max_idx, 1).to_dicts()[0] if max_idx is not None else {}
-    last_point = df.slice(-1, 1).to_dicts()[0]
+    last_point = cast(CommitDataRow, df.slice(-1, 1).to_dicts()[0])
+    
+    marker_x: list[datetime] = []
+    marker_y: list[int] = []
+    marker_sizes: list[int] = []
+    marker_colors: list[str] = []
+    marker_symbols: list[str] = []
+    marker_texts: list[str] = []
+    
+    if min_idx is not None:
+        min_point = cast(CommitDataRow, df.slice(min_idx, 1).to_dicts()[0])
+        marker_x.append(min_point["dtmExit"])
+        marker_y.append(min_point["lines"])
+        marker_sizes.append(10)
+        marker_colors.append("#ff4f4f")
+        marker_symbols.append("circle")
+        marker_texts.append(f"🔽 Min: {min_point['lines']:,} lines")
+    
+    if max_idx is not None:
+        max_point = cast(CommitDataRow, df.slice(max_idx, 1).to_dicts()[0])
+        marker_x.append(max_point["dtmExit"])
+        marker_y.append(max_point["lines"])
+        marker_sizes.append(14)
+        marker_colors.append("#4fff4f")
+        marker_symbols.append("star")
+        marker_texts.append(f"🔼 Max: {max_point['lines']:,} lines")
+    
+    marker_x.append(last_point["dtmExit"])
+    marker_y.append(last_point["lines"])
+    marker_sizes.append(12)
+    marker_colors.append("#4f4fff")
+    marker_symbols.append("diamond")
+    marker_texts.append(f"📊 Current: {last_point['lines']:,} lines")
 
     # Add markers for significant points
     fig.add_trace(
         go.Scatter(
-            x=[min_point["dtmExit"], max_point["dtmExit"], last_point["dtmExit"]],
-            y=[min_point["lines"], max_point["lines"], last_point["lines"]],
+            x=marker_x,
+            y=marker_y,
             mode="markers",
-            marker={"size": [10, 14, 12], "color": ["#ff4f4f", "#4fff4f", "#4f4fff"], "line": {"width": 2, "color": "white"}, "symbol": ["circle", "star", "diamond"]},
+            marker={"size": marker_sizes, "color": marker_colors, "line": {"width": 2, "color": "white"}, "symbol": marker_symbols},
             name="Key Points",
             hovertemplate="<b>%{text}</b><br>Date: %{x}<br>Lines: %{y:,}<extra></extra>",
-            text=[f"🔽 Min: {min_point['lines']:,} lines", f"🔼 Max: {max_point['lines']:,} lines", f"📊 Current: {last_point['lines']:,} lines"],
+            text=marker_texts,
         )
     )
 
@@ -264,6 +306,8 @@ def analyze_over_time(repo_path: str):
     # Print statistics
     print("\n📊 Repository Statistics:")
     print(f"📚 Total commits analyzed: {len(df)}")
-    print(f"🔙 Initial line count: {df['lines'][-1]:,}")
-    print(f"🔜 Final line count: {df['lines'][0]:,}")
-    print(f"📈 Net change: {df['lines'][0] - df['lines'][-1]:,} lines")
+    initial_lines = int(df['lines'][-1])
+    final_lines = int(df['lines'][0])
+    print(f"🔙 Initial line count: {initial_lines:,}")
+    print(f"🔜 Final line count: {final_lines:,}")
+    print(f"📈 Net change: {final_lines - initial_lines:,} lines")

machineconfig/scripts/python/{helpers_repos → helpers/helpers_repos}/update.py

@@ -246,12 +246,6 @@ def update_repository(repo: git.Repo, auto_uv_sync: bool, allow_password_prompt:
                 result["permissions_updated"] = True
                 print(f"✅ Set permissions for {linux_jobs_path}")
 
-            lf_exe_path = repo_path / "src" / "machineconfig" / "settings" / "lf" / "linux" / "exe"
-            if lf_exe_path.exists():
-                set_permissions_recursive(lf_exe_path)
-                result["permissions_updated"] = True
-                print(f"✅ Set permissions for {lf_exe_path}")
-
         # Run uv sync if dependencies changed and auto_sync is enabled
         if result["dependencies_changed"] and auto_uv_sync:
             result["uv_sync_ran"] = True

machineconfig/scripts/python/helpers/helpers_search/script_help.py

@@ -0,0 +1,81 @@
+
+from typing import Literal
+
+
+def list_available_scripts(where: Literal["all", "a", "private", "p", "public", "b", "library", "l", "dynamic", "d", "custom", "c"]) -> None:
+    from pathlib import Path
+    from machineconfig.utils.source_of_truth import CONFIG_ROOT, LIBRARY_ROOT, DEFAULTS_PATH
+
+    private_root = Path.home().joinpath("dotfiles/scripts")
+    public_root = CONFIG_ROOT.joinpath("scripts")
+    library_root = LIBRARY_ROOT.joinpath("jobs", "scripts")
+
+    def get_custom_roots() -> list[Path]:
+        custom_roots: list[Path] = []
+        if DEFAULTS_PATH.is_file():
+            from configparser import ConfigParser
+            config = ConfigParser()
+            config.read(DEFAULTS_PATH)
+            if config.has_section("general") and config.has_option("general", "scripts"):
+                custom_dirs = config.get("general", "scripts").split(",")
+                for custom_dir in custom_dirs:
+                    custom_path = Path(custom_dir.strip()).expanduser().resolve()
+                    if custom_path.is_dir():
+                        custom_roots.append(custom_path)
+        return custom_roots
+
+    locations: dict[str, Path | str] = {}
+    match where:
+        case "all" | "a":
+            locations = {"private": private_root, "public": public_root, "library": library_root}
+            for idx, custom in enumerate(get_custom_roots()): locations[f"custom_{idx}"] = custom
+            locations["dynamic"] = "https://github.com/thisismygitrepo/machineconfig/tree/main/src/machineconfig/jobs/scripts_dynamic"
+        case "private" | "p":
+            locations = {"private": private_root}
+        case "public" | "b":
+            locations = {"public": public_root}
+        case "library" | "l":
+            locations = {"library": library_root}
+        case "dynamic" | "d":
+            locations = {"dynamic": "https://github.com/thisismygitrepo/machineconfig/tree/main/src/machineconfig/jobs/scripts_dynamic"}
+        case "custom" | "c":
+            for idx, custom in enumerate(get_custom_roots()): locations[f"custom_{idx}"] = custom
+
+    def _print_files_by_type(files: list[str]) -> None:
+        categories: dict[str, list[str]] = {".py": [], ".sh": [], ".ps1": [], ".cmd": [], ".bat": [], "other": []}
+        for f in files:
+            ext = Path(f).suffix.lower() if "." in str(f) else ""
+            if ext in categories: categories[ext].append(str(f))
+            else: categories["other"].append(str(f))
+        for ext, cat_files in categories.items():
+            if cat_files:
+                label = ext if ext else "other"
+                print(f"    [{label}]")
+                for cf in sorted(cat_files): print(f"      • {cf}")
+
+    for loc_name, loc_path in locations.items():
+        print(f"\n📁 {loc_name.upper()} ({loc_path}):")
+        print("-" * 60)
+        if isinstance(loc_path, Path):
+            if loc_path.is_dir():
+                files = [f for f in loc_path.rglob("*") if f.is_file() and f.suffix in (".py", ".sh", ".ps1", ".bat", ".cmd", "")]
+                if files:
+                    relative_files = [str(f.relative_to(loc_path)) for f in files]
+                    _print_files_by_type(relative_files)
+                else:
+                    print("  (empty)")
+            else:
+                print("  ⚠️  Directory does not exist")
+        else:
+            api_url = "https://api.github.com/repos/thisismygitrepo/machineconfig/contents/src/machineconfig/jobs/scripts_dynamic"
+            try:
+                import requests
+                response = requests.get(api_url, timeout=10)
+                if response.status_code == 200:
+                    items = response.json()
+                    files = [item["name"] for item in items if item["type"] == "file"]
+                    _print_files_by_type(files)
+                else:
+                    print(f"  ⚠️  Could not fetch from GitHub (status: {response.status_code})")
+            except Exception as e:
+                print(f"  ⚠️  Could not fetch from GitHub: {e}")