machineconfig 8.12__py3-none-any.whl → 8.45__py3-none-any.whl

machineconfig/scripts/python/agents.py

@@ -1,10 +1,8 @@
-"""Utilitfrom pathlib import Path
+"""Agents management commands - lazy loading subcommands."""
 
-"""
-
-from typing import cast, Optional, get_args, Annotated
+from typing import Optional, get_args, Annotated, Literal
 import typer
-from machineconfig.scripts.python.helpers_agents.fire_agents_helper_types import AGENTS, HOST, PROVIDER
+from machineconfig.scripts.python.helpers.helpers_agents.fire_agents_helper_types import AGENTS, HOST, PROVIDER
 
 
 def agents_create(
@@ -21,169 +19,74 @@ def agents_create(
     separate: Annotated[bool, typer.Option(..., "--separate", "-S", help="Keep prompt material in separate file to the context.")] = True,
     output_path: Annotated[Optional[str], typer.Option(..., "--output-path", "-o", help="Path to write the layout.json file")] = None,
     agents_dir: Annotated[Optional[str], typer.Option(..., "--agents-dir", "-ad", help="Directory to store agent files. If not provided, will be constructed automatically.")] = None,
-):
-
-    from machineconfig.scripts.python.helpers_agents.fire_agents_help_launch import prep_agent_launch, get_agents_launch_layout
-    from machineconfig.scripts.python.helpers_agents.fire_agents_load_balancer import chunk_prompts
-    from machineconfig.utils.accessories import get_repo_root, randstr
-    import json
-    from pathlib import Path
-    # validate mutual exclusive
-    prompt_options = [prompt, prompt_path]
-    provided_prompt = [opt for opt in prompt_options if opt is not None]
-    if len(provided_prompt) != 1:
-        raise typer.BadParameter("Exactly one of --prompt or --prompt-path must be provided")
-    
-    repo_root = get_repo_root(Path.cwd())
-    if repo_root is None:
-        typer.echo("💥 Could not determine the repository root. Please run this script from within a git repository.")
-        raise typer.Exit(1)
-        return
-    typer.echo(f"Operating @ {repo_root}")
-    
-    if context_path is None:
-        context_path_resolved = Path(repo_root) / ".ai" / "todo"
-    else: context_path_resolved = Path(context_path).expanduser().resolve()
-
-    if not context_path_resolved.exists():
-        raise typer.BadParameter(f"Path does not exist: {context_path_resolved}")
-    
-    if context_path_resolved.is_file():
-        prompt_material_re_splitted = chunk_prompts(context_path_resolved, tasks_per_prompt=agent_load, joiner=separator)
-    elif context_path_resolved.is_dir():
-        files = [f for f in context_path_resolved.rglob("*") if f.is_file()]
-        if not files:
-            raise typer.BadParameter(f"No files found in directory: {context_path_resolved}")
-        concatenated = separator.join(f.read_text(encoding="utf-8") for f in files)
-        prompt_material_re_splitted = [concatenated]
-    else:
-        raise typer.BadParameter(f"Path is neither file nor directory: {context_path_resolved}")
+) -> None:
+    """Create agents layout file, ready to run."""
+    from machineconfig.scripts.python.helpers.helpers_agents.agents_impl import agents_create as impl
+    try:
+        impl(agent=agent, host=host, model=model, provider=provider, context_path=context_path, separator=separator, agent_load=agent_load, prompt=prompt, prompt_path=prompt_path, job_name=job_name, separate=separate, output_path=output_path, agents_dir=agents_dir)
+    except ValueError as e:
+        raise typer.BadParameter(str(e)) from e
+    except RuntimeError as e:
+        typer.echo(str(e))
+        raise typer.Exit(1) from e
     
-    if prompt_path is not None:
-        prompt_prefix = Path(prompt_path).read_text(encoding="utf-8")
-    else:
-        prompt_prefix = cast(str, prompt)
-    agent_selected = agent
-    if agents_dir is None: agents_dir_obj = Path(repo_root) / ".ai" / f"tmp_prompts/{job_name}_{randstr()}"
-    else:
-        import shutil
-        if Path(agents_dir).exists():
-            shutil.rmtree(agents_dir)
-        agents_dir_obj = Path(agents_dir)
-    prep_agent_launch(repo_root=repo_root, agents_dir=agents_dir_obj, prompts_material=prompt_material_re_splitted,
-                      keep_material_in_separate_file=separate,
-                      prompt_prefix=prompt_prefix, machine=host, agent=agent_selected, model=model, provider=provider,
-                      job_name=job_name)
-    layoutfile = get_agents_launch_layout(session_root=agents_dir_obj)
-#     regenerate_py_code = f"""
-# #!/usr/bin/env uv run --python 3.14 --with machineconfig
-# agents create "{context_path_resolved}" \\
-#     --prompt-path "{prompt_path or ''}" \\
-#     --agent "{agent_selected}" \\
-#     --host "{host}" \\
-#     --job-name "{job_name}" \\
-#     --agent_load {agent_load} \\
-#     --separator "{separator}" \\
-#     {"--separate" if separate else ""}
-# """
-#     (agents_dir_obj / "aa_agents_relaunch.sh").write_text(data=regenerate_py_code, encoding="utf-8")
-    layout_output_path = Path(output_path) if output_path is not None else agents_dir_obj / "layout.json"
-    layout_output_path.parent.mkdir(parents=True, exist_ok=True)
-    layout_output_path.write_text(data=json.dumps(layoutfile, indent=4), encoding="utf-8")
-    typer.echo(f"Created agents in {agents_dir_obj}")
-    typer.echo(f"Ceated layout in {layout_output_path}")
-
-
 def collect(
     agent_dir: Annotated[str, typer.Argument(..., help="Path to the agent directory containing the prompts folder")],
     output_path: Annotated[str, typer.Argument(..., help="Path to write the concatenated material files")],
     separator: Annotated[str, typer.Option(..., help="Separator to use when concatenating material files")] = "\n",
 ) -> None:
     """Collect all material files from an agent directory and concatenate them."""
-    from pathlib import Path
-    if not Path(agent_dir).exists() or not Path(agent_dir).is_dir():
-        raise typer.BadParameter(f"Agent directory does not exist or is not a directory: {agent_dir}")
-    
-    prompts_dir = Path(agent_dir) / "prompts"
-    if not prompts_dir.exists():
-        raise typer.BadParameter(f"Prompts directory not found: {prompts_dir}")
-    
-    material_files = []
-    for agent_subdir in prompts_dir.iterdir():
-        if agent_subdir.is_dir() and agent_subdir.name.startswith("agent_"):
-            material_file = agent_subdir / f"{agent_subdir.name}_material.txt"
-            if material_file.exists():
-                material_files.append(material_file)
-    
-    if not material_files:
-        typer.echo("No material files found in the agent directory.")
-        return
-    
-    # Sort by agent index for consistent ordering
-    material_files.sort(key=lambda x: int(x.parent.name.split("_")[-1]))
-    
-    # Read and concatenate all material files
-    concatenated_content = []
-    for material_file in material_files:
-        content = material_file.read_text(encoding="utf-8")
-        concatenated_content.append(content)
-    
-    result = separator.join(concatenated_content)
-    
-    # Write to output file
-    Path(output_path).parent.mkdir(parents=True, exist_ok=True)
-    Path(output_path).write_text(result, encoding="utf-8")
-    typer.echo(f"Concatenated material written to {output_path}")
-
-
-def make_agents_command_template():
-    """Create a template for fire agents"""
-    from platform import system
-    import machineconfig.scripts.python.helpers_agents as module
-    from pathlib import Path
-
-    if system() == "Linux" or system() == "Darwin":
-        template_path = Path(module.__file__).parent / "templates/template.sh"
-    elif system() == "Windows":
-        template_path = Path(module.__file__).parent / "templates/template.ps1"
-    else:
-        raise typer.BadParameter(f"Unsupported OS: {system()}")
-
-    from machineconfig.utils.accessories import get_repo_root
-    repo_root = get_repo_root(Path.cwd())
-    if repo_root is None:
-        typer.echo("💥 Could not determine the repository root. Please run this script from within a git repository.")
-        raise typer.Exit(1)
-
-    save_path_root = repo_root / ".ai" / "agents"
-
-    save_path_root.mkdir(parents=True, exist_ok=True)
-    save_path_root.joinpath("template_fire_agents.sh").write_text(template_path.read_text(encoding="utf-8"), encoding="utf-8")
-    typer.echo(f"Template bash script written to {save_path_root}")
-
-    from machineconfig.scripts.python.ai.utils.generate_files import make_todo_files
-    make_todo_files(
-        pattern=".py", repo=str(repo_root), strategy="name", output_path=str(save_path_root / "files.md"), split_every=None, split_to=None
-    )
-
-    prompt_path = Path(module.__file__).parent / "templates/prompt.txt"
-    save_path_root.joinpath("prompt.txt").write_text(prompt_path.read_text(encoding="utf-8"), encoding="utf-8")
-    typer.echo(f"Prompt template written to {save_path_root}")
-
-
-def init_config(root: Annotated[Optional[str], typer.Option(..., "--root", "-r", help="Root directory of the repository to initialize AI configs in. Defaults to current directory.")] = None):
-    """Initialize AI configurations in the current repository"""
-    from machineconfig.scripts.python.ai.initai import add_ai_configs
-    from pathlib import Path
-    if root is None:
-        repo_root = Path.cwd()
-    else:
-        repo_root = Path(root).expanduser().resolve()
-    add_ai_configs(repo_root=repo_root)
-
-
-def get_app():
-    agents_app = typer.Typer(help="🤖 AI Agents management subcommands", no_args_is_help=True, add_help_option=False, add_completion=False)
+    from machineconfig.scripts.python.helpers.helpers_agents.agents_impl import collect as impl
+    try:
+        impl(agent_dir=agent_dir, output_path=output_path, separator=separator)
+    except ValueError as e:
+        raise typer.BadParameter(str(e)) from e
+
+
+def make_agents_command_template() -> None:
+    """Create a template for fire agents."""
+    from machineconfig.scripts.python.helpers.helpers_agents.agents_impl import make_agents_command_template as impl
+    try:
+        impl()
+    except ValueError as e:
+        raise typer.BadParameter(str(e)) from e
+    except RuntimeError as e:
+        typer.echo(str(e))
+        raise typer.Exit(1) from e
+
+
+def init_config(root: Annotated[Optional[str], typer.Option(..., "--root", "-r", help="Root directory of the repository to initialize AI configs in. Defaults to current directory.")] = None) -> None:
+    """Initialize AI configurations in the current repository."""
+    from machineconfig.scripts.python.helpers.helpers_agents.agents_impl import init_config as impl
+    impl(root=root)
+
+
+def make_todo_files(
+    pattern: Annotated[str, typer.Argument(help="Pattern or keyword to match files by")] = ".py",
+    repo: Annotated[str, typer.Argument(help="Repository path. Can be any directory within a git repository.")] = ".",
+    strategy: Annotated[Literal["name", "keywords"], typer.Option("-s", "--strategy", help="Strategy to filter files: 'name' for filename matching, 'keywords' for content matching")] = "name",
+    exclude_init: Annotated[bool, typer.Option("-x", "--exclude-init", help="Exclude __init__.py files from the checklist")] = True,
+    include_line_count: Annotated[bool, typer.Option("-l", "--line-count", help="Include line count column in the output")] = False,
+    output_path: Annotated[str, typer.Option("-o", "--output-path", help="Base path for output files relative to repo root")] = ".ai/todo/files",
+    format_type: Annotated[Literal["csv", "md", "txt"], typer.Option("-f", "--format", help="Output format: csv, md (markdown), or txt")] = "md",
+    split_every: Annotated[Optional[int], typer.Option("--split-every", "-e", help="Split output into multiple files, each containing at most this many results")] = None,
+    split_to: Annotated[Optional[int], typer.Option("--split-to", "-t", help="Split output into exactly this many files")] = None,
+) -> None:
+    """Generate checklist with Python and shell script files in the repository filtered by pattern."""
+    from machineconfig.scripts.python.ai.utils.generate_files import make_todo_files as impl
+    impl(pattern=pattern, repo=repo, strategy=strategy, exclude_init=exclude_init, include_line_count=include_line_count, output_path=output_path, format_type=format_type, split_every=split_every, split_to=split_to)
+
+
+def create_symlink_command(
+    num: Annotated[int, typer.Argument(help="Number of symlinks to create (1-5).")] = 5,
+) -> None:
+    """Create symlinks to repo_root at ~/code_copies/${repo_name}_copy_{i}."""
+    from machineconfig.scripts.python.ai.utils.generate_files import create_symlink_command as impl
+    impl(num=num)
+
+
+def get_app() -> typer.Typer:
+    agents_app = typer.Typer(help="🤖 AI Agents management subcommands", no_args_is_help=True, add_help_option=True, add_completion=False)
     sep = "\n"
     agents_full_help = f"""
 [c] Create agents layout file, ready to run.
@@ -201,22 +104,17 @@ AGENT options: {', '.join(get_args(AGENTS))}
     agents_app.command("t", no_args_is_help=False, help=make_agents_command_template.__doc__, hidden=True)(make_agents_command_template)
     agents_app.command("make-config", no_args_is_help=False, help=init_config.__doc__, short_help="[g] Initialize AI configurations in the current repository")(init_config)
     agents_app.command("g", no_args_is_help=False, help=init_config.__doc__, hidden=True)(init_config)
-    from machineconfig.scripts.python.ai.utils.generate_files import make_todo_files
-    agents_app.command("make-todo", no_args_is_help=True, help=make_todo_files.__doc__, short_help="[d] Generate a markdown file listing all Python files in the repo")(make_todo_files)
-    agents_app.command("d", no_args_is_help=True, help=make_todo_files.__doc__, hidden=True)(make_todo_files)
-    from machineconfig.scripts.python.ai.utils.generate_files import create_symlink_command
-    agents_app.command(name="make-symlinks", no_args_is_help=True, help=create_symlink_command.__doc__, short_help="[s] Create symlinks to the current repo in ~/code_copies/")(create_symlink_command)
-    agents_app.command(name="s", no_args_is_help=True, help=create_symlink_command.__doc__, hidden=True)(create_symlink_command)
+    agents_app.command("make-todo", no_args_is_help=True, short_help="[d] Generate a markdown file listing all Python files in the repo")(make_todo_files)
+    agents_app.command("d", no_args_is_help=True, hidden=True)(make_todo_files)
+    agents_app.command(name="make-symlinks", no_args_is_help=True, short_help="[s] Create symlinks to the current repo in ~/code_copies/")(create_symlink_command)
+    agents_app.command(name="s", no_args_is_help=True, hidden=True)(create_symlink_command)
     return agents_app
 
 
-def main():
+def main() -> None:
     agents_app = get_app()
-    # from trogon.typer import init_tui
-    # agents_app_tui = init_tui(agents_app)
     agents_app()
-    # agents_app_tui()
 
 
-if __name__ == "__main__":  # pragma: no cover
+if __name__ == "__main__":
     pass

machineconfig/scripts/python/ai/initai.py

@@ -1,6 +1,6 @@
 from pathlib import Path
 
-from machineconfig.scripts.python.ai.solutions import generic
+from machineconfig.scripts.python.ai.utils import generic
 from machineconfig.scripts.python.ai.solutions.claude import claude
 from machineconfig.scripts.python.ai.solutions.cline import cline
 from machineconfig.scripts.python.ai.solutions.copilot import github_copilot
@@ -20,6 +20,8 @@ def add_ai_configs(repo_root: Path) -> None:
     dot_scripts_dir = repo_root.joinpath(".scripts")
     dot_scripts_dir.mkdir(parents=True, exist_ok=True)
     generic.create_dot_scripts(repo_root=repo_root)
+    if not repo_root.joinpath(".gitignore").exists():
+        repo_root.joinpath(".gitignore").touch()
     generic.adjust_gitignore(repo_root=repo_root)
 
     add_lint_and_type_check_task(repo_root=repo_root)

machineconfig/scripts/python/ai/scripts/__init__.py

@@ -0,0 +1 @@
+

machineconfig/scripts/python/ai/scripts/lint_and_type_check.ps1

@@ -52,6 +52,8 @@ uv add --dev pylint --upgrade-package pylint
 uv add --dev mypy --upgrade-package mypy
 uv add --dev pyrefly --upgrade-package pyrefly
 uv add --dev cleanpy --upgrade-package cleanpy
+uv add --dev ruff --upgrade-package ruff
+uv add --dev ty --upgrade-package ty
 
 uv add types-requests types-toml types-PyYAML types-pytz types-paramiko types-urllib3 --dev
 uv add types-mysqlclient types-SQLAlchemy --dev

machineconfig/scripts/python/ai/scripts/lint_and_type_check.sh

@@ -56,6 +56,8 @@ uv add --dev pylint --upgrade-package pylint
 uv add --dev mypy --upgrade-package mypy
 uv add --dev pyrefly --upgrade-package pyrefly
 uv add --dev cleanpy --upgrade-package cleanpy
+uv add --dev ruff --upgrade-package ruff
+uv add --dev ty --upgrade-package ty
 
 uv add types-requests types-toml types-PyYAML types-pytz types-paramiko types-urllib3 --dev
 uv add types-mysqlclient types-SQLAlchemy --dev
@@ -81,35 +83,35 @@ draw_box "🔍 TYPE CHECKERS & LINTERS 🔍" "${BOLD}${PURPLE}"
 ((CURRENT_STEP++))
 draw_progress $CURRENT_STEP $TOTAL_STEPS "Pyright Type Checker"
 echo -e "${BLUE}📋 Analyzing types with Pyright...${NC}"
-rm ./.ai/linters/issues_pyright.md || true
+rm -f ./.ai/linters/issues_pyright.md || true
 uv run pyright . > ./.ai/linters/issues_pyright.md
 echo -e "${GREEN}✅ Results saved to ${UNDERLINE}./.ai/linters/issues_pyright.md${NC}"
 
 ((CURRENT_STEP++))
 draw_progress $CURRENT_STEP $TOTAL_STEPS "MyPy Type Checker"
 echo -e "${BLUE}📋 Analyzing types with MyPy...${NC}"
-rm ./.ai/linters/issues_mypy.md || true
+rm -f ./.ai/linters/issues_mypy.md || true
 uv run mypy . > ./.ai/linters/issues_mypy.md
 echo -e "${GREEN}✅ Results saved to ${UNDERLINE}./.ai/linters/issues_mypy.md${NC}"
 
 ((CURRENT_STEP++))
 draw_progress $CURRENT_STEP $TOTAL_STEPS "Pylint Code Analysis"
 echo -e "${BLUE}📋 Analyzing code quality with Pylint...${NC}"
-rm ./.ai/linters/issues_pylint.md || true
+rm -f ./.ai/linters/issues_pylint.md || true
 uv run pylint --recursive=y . > ./.ai/linters/issues_pylint.md
 echo -e "${GREEN}✅ Results saved to ${UNDERLINE}./.ai/linters/issues_pylint.md${NC}"
 
 ((CURRENT_STEP++))
 draw_progress $CURRENT_STEP $TOTAL_STEPS "Pyrefly Type Checker"
 echo -e "${BLUE}📋 Analyzing types with Pyrefly...${NC}"
-rm ./.ai/linters/issues_pyrefly.md || true
+rm -f ./.ai/linters/issues_pyrefly.md || true
 uv run pyrefly check . > ./.ai/linters/issues_pyrefly.md
 echo -e "${GREEN}✅ Results saved to ${UNDERLINE}./.ai/linters/issues_pyrefly.md${NC}"
 
 ((CURRENT_STEP++))
 draw_progress $CURRENT_STEP $TOTAL_STEPS "Ruff Linter"
 echo -e "${BLUE}📋 Checking code style with Ruff...${NC}"
-rm ./.ai/linters/issues_ruff.md || true
+rm -f ./.ai/linters/issues_ruff.md || true
 uv run ruff check . > ./.ai/linters/issues_ruff.md
 echo -e "${GREEN}✅ Results saved to ${UNDERLINE}./.ai/linters/issues_ruff.md${NC}"
 

machineconfig/scripts/python/ai/solutions/claude/claude.py

@@ -1,6 +1,6 @@
 from pathlib import Path
 
-from machineconfig.scripts.python.ai.solutions._shared import get_generic_instructions_path
+from machineconfig.scripts.python.ai.utils.shared import get_generic_instructions_path
 
 
 def build_configuration(repo_root: Path) -> None:

machineconfig/scripts/python/ai/solutions/cline/cline.py

@@ -1,6 +1,6 @@
 from pathlib import Path
 
-from machineconfig.scripts.python.ai.solutions._shared import get_generic_instructions_path
+from machineconfig.scripts.python.ai.utils.shared import get_generic_instructions_path
 
 
 def build_configuration(repo_root: Path) -> None:

machineconfig/scripts/python/ai/solutions/copilot/github_copilot.py

@@ -1,6 +1,6 @@
 from pathlib import Path
 
-from machineconfig.scripts.python.ai.solutions._shared import get_generic_instructions_path
+from machineconfig.scripts.python.ai.utils.shared import get_generic_instructions_path
 from machineconfig.utils.source_of_truth import LIBRARY_ROOT
 
 

machineconfig/scripts/python/ai/solutions/copilot/instructions/python/dev.instructions.md

@@ -35,6 +35,35 @@ applyTo: "**/*.py"
 * Please run `uv run -m pyright $file_touched` and address all issues. if `pyright is not there, first run `uv add pyright --dev`.
 * For all type checkers and linters, like mypy, pyright, pyrefly and pylint, there are config files at different levels of the repo all the way up to home directory level. You don't need to worry about them, just be mindful that they exist. The tools themselves will respect the configs therein.
 * If you want to run all linters and pycheckers agains the entire project to make sure everything is clean, I prepared a nice shell script, you can run it from the repo root as `./.ai/scripts/lint_and_type_check.sh`. It will produce markdown files that are you are meant to look at @ ./.ai/linters/*.md
+* Rust-inspired style, e.g.
+from typing import Literal, Optional, TypeAlias
+class Success:
+  def __init__(self, value: int):
+    self.value = value
+FAILURE_REASON: TypeAlias = Literal["cache_missing", "service_history_missing"]
+class Failure:
+    def __init__(self, reason: FAILURE_REASON, message: Optional[str] = None):
+        self.reason: FAILURE_REASON = reason
+        self.message = message
+def fallible_function(a: int, b: int) -> Success | Failure:
+    if a > b: return Success(value=a+b)
+    else: return Failure(reason="service_history_missing", message="a is not greater than b")
+def example_usage() -> None:
+    result = fallible_function(2, 3)
+    match result:
+        case Success():  # Correct
+            print("Addition succeeded.")
+        case Failure():  # <--- Looks wrong, because no variable passed, but its correct, it works like this in python3.11+
+            # Now this only matches if result IS a Failure instance
+            print("Addition failed.")
+            print(f"Reason: {result.reason}, Message: {result.message}")
+            q = result.reason
+            match q:
+                case "cache_missing":
+                    print("Handle cache missing scenario.")
+                case "service_history_missing":
+                    print("Handle service history missing scenario.")
+
 
 # General Programming Ethos:
 * Make sure all the code is rigorous, no lazy stuff.

machineconfig/scripts/python/ai/solutions/crush/crush.py

@@ -7,7 +7,7 @@ ref: https://github.com/charmbracelet/crush
 
 from pathlib import Path
 import platform
-from machineconfig.scripts.python.ai.solutions._shared import get_generic_instructions_path
+from machineconfig.scripts.python.ai.utils.shared import get_generic_instructions_path
 
 
 

machineconfig/scripts/python/ai/solutions/cursor/cursors.py

@@ -1,6 +1,6 @@
 from pathlib import Path
 
-from machineconfig.scripts.python.ai.solutions._shared import get_generic_instructions_path
+from machineconfig.scripts.python.ai.utils.shared import get_generic_instructions_path
 
 
 def build_configuration(repo_root: Path) -> None:

machineconfig/scripts/python/ai/solutions/gemini/gemini.py

@@ -1,6 +1,6 @@
 from pathlib import Path
 
-from machineconfig.scripts.python.ai.solutions._shared import get_generic_instructions_path
+from machineconfig.scripts.python.ai.utils.shared import get_generic_instructions_path
 from machineconfig.utils.source_of_truth import LIBRARY_ROOT
 
 def build_configuration(repo_root: Path) -> None:

machineconfig/scripts/python/ai/solutions/gemini/settings.json

@@ -1,4 +1,7 @@
 {
+  "general": {
+    "previewFeatures": true
+  },
   // Appearance
   "theme": "Default",          // Could also be "GitHub", "Dracula", etc.
 

machineconfig/scripts/python/ai/{solutions → utils}/generic.py

@@ -40,21 +40,8 @@ def adjust_gitignore(repo_root: Path) -> None:
 
     dot_git_ignore_content = dot_git_ignore_path.read_text(encoding="utf-8")
     entries_to_add: list[str] = []
-    required_entries: list[str] = [
-        ".links",
-        "notebooks",
-        ".ai",
-        "GEMINI.md",
-        "CLAUDE.md",
-        "CRUSH.md",
-        ".cursor",
-        ".clinerules",
-        ".github/instructions",
-        ".github/agents",
-        ".github/prompts",
-    ]
-
-    for entry in required_entries:
+    from machineconfig.utils.source_of_truth import EXCLUDE_DIRS
+    for entry in EXCLUDE_DIRS:
         if entry not in dot_git_ignore_content:
             entries_to_add.append(entry)
 

machineconfig/scripts/python/ai/utils/vscode_tasks.py

@@ -27,9 +27,12 @@ def add_lint_and_type_check_task(repo_root: Path) -> None:
             assert isinstance(tasks_config, dict)
         if "tasks" not in tasks_config:
             tasks_config["tasks"] = []
-        existing_labels = {task.get("label") for task in tasks_config.get("tasks", [])}
-        if "lintAndTypeCheck" not in existing_labels:
-            tasks_config["tasks"].append(task_to_add)
+        
+        # Remove any existing entries with the same label to prevent duplicates
+        tasks_config["tasks"] = [
+            t for t in tasks_config["tasks"] if t.get("label") != task_to_add["label"]
+        ]
+        tasks_config["tasks"].append(task_to_add)
     else:
         tasks_config = {"version": "2.0.0", "tasks": [task_to_add]}
 

machineconfig/scripts/python/cloud.py

@@ -1,20 +1,67 @@
+"""Cloud management commands - lazy loading subcommands."""
 
 import typer
-from machineconfig.scripts.python.helpers_cloud.cloud_sync import main as sync_main
-from machineconfig.scripts.python.helpers_cloud.cloud_copy import main as copy_main
-from machineconfig.scripts.python.helpers_cloud.cloud_mount import mount as mount_main
+from typing import Optional, Annotated
 
-def get_app():
-    app = typer.Typer(add_completion=False, no_args_is_help=True)
 
-    app.command(name="sync", no_args_is_help=True, help=sync_main.__doc__, short_help="""🔄 [s] Synchronize files/folders between local and cloud storage.""")(sync_main)
-    app.command(name="s", no_args_is_help=True, help=sync_main.__doc__, hidden=True)(sync_main)  # short alias
+def sync(
+    source: Annotated[str, typer.Argument(help="source")],
+    target: Annotated[str, typer.Argument(help="target")],
+    transfers: Annotated[int, typer.Option("--transfers", "-t", help="Number of threads in syncing.")] = 10,
+    root: Annotated[str, typer.Option("--root", "-R", help="Remote root.")] = "myhome",
+    key: Annotated[Optional[str], typer.Option("--key", "-k", help="Key for encryption")] = None,
+    pwd: Annotated[Optional[str], typer.Option("--pwd", "-P", help="Password for encryption")] = None,
+    encrypt: Annotated[bool, typer.Option("--encrypt", "-e", help="Decrypt after receiving.")] = False,
+    zip_: Annotated[bool, typer.Option("--zip", "-z", help="unzip after receiving.")] = False,
+    bisync: Annotated[bool, typer.Option("--bisync", "-b", help="Bidirectional sync.")] = False,
+    delete: Annotated[bool, typer.Option("--delete", "-D", help="Delete files in remote that are not in local.")] = False,
+    verbose: Annotated[bool, typer.Option("--verbose", "-v", help="Verbosity of mprocs to show details of syncing.")] = False,
+) -> None:
+    """🔄 Synchronize files/folders between local and cloud storage."""
+    from machineconfig.scripts.python.helpers.helpers_cloud.cloud_sync import main as sync_main
+    sync_main(source=source, target=target, transfers=transfers, root=root, key=key, pwd=pwd, encrypt=encrypt, zip_=zip_, bisync=bisync, delete=delete, verbose=verbose)
 
-    app.command(name="copy", no_args_is_help=True, help=copy_main.__doc__, short_help="""📤 [c] Upload or 📥 Download files/folders to/from cloud storage services like Google Drive, Dropbox, OneDrive, etc.""")(copy_main)
-    app.command(name="c", no_args_is_help=True, help=copy_main.__doc__, hidden=True)(copy_main)  # short alias
 
-    app.command(name="mount", no_args_is_help=True, help=mount_main.__doc__, short_help="""🔗 [m] Mount cloud storage services like Google Drive, Dropbox, OneDrive, etc. as local drives.""")(mount_main)
-    app.command(name="m", no_args_is_help=True, help=mount_main.__doc__, hidden=True)(mount_main)  # short alias
+def copy(
+    source: Annotated[str, typer.Argument(help="📂 file/folder path to be taken from here.")],
+    target: Annotated[str, typer.Argument(help="🎯 file/folder path to be be sent to here.")],
+    overwrite: Annotated[bool, typer.Option("--overwrite", "-o", help="✍️ Overwrite existing file.")] = False,
+    share: Annotated[bool, typer.Option("--share", "-s", help="🔗 Share file / directory")] = False,
+    rel2home: Annotated[bool, typer.Option("--relative2home", "-r", help="🏠 Relative to `myhome` folder")] = False,
+    root: Annotated[Optional[str], typer.Option("--root", "-R", help="🌳 Remote root. None is the default, unless rel2home is raied, making the default `myhome`.")] = None,
+    key: Annotated[Optional[str], typer.Option("--key", "-k", help="🔑 Key for encryption")] = None,
+    pwd: Annotated[Optional[str], typer.Option("--password", "-p", help="🔒 Password for encryption")] = None,
+    encrypt: Annotated[bool, typer.Option("--encrypt", "-e", help="🔐 Encrypt before sending.")] = False,
+    zip_: Annotated[bool, typer.Option("--zip", "-z", help="📦 unzip after receiving.")] = False,
+    os_specific: Annotated[bool, typer.Option("--os-specific", "-O", help="💻 choose path specific for this OS.")] = False,
+    config: Annotated[Optional[str], typer.Option("--config", "-c", help="⚙️ path to cloud.json file.")] = None,
+) -> None:
+    """📤 Upload or 📥 Download files/folders to/from cloud storage services."""
+    from machineconfig.scripts.python.helpers.helpers_cloud.cloud_copy import main as copy_main
+    copy_main(source=source, target=target, overwrite=overwrite, share=share, rel2home=rel2home, root=root, key=key, pwd=pwd, encrypt=encrypt, zip_=zip_, os_specific=os_specific, config=config)
+
+
+def mount(
+    cloud: Annotated[Optional[str], typer.Option(help="cloud to mount")] = None,
+    destination: Annotated[Optional[str], typer.Option(help="destination to mount")] = None,
+    network: Annotated[Optional[str], typer.Option(help="mount network drive")] = None,
+) -> None:
+    """🔗 Mount cloud storage services as local drives."""
+    from machineconfig.scripts.python.helpers.helpers_cloud.cloud_mount import mount as mount_main
+    mount_main(cloud=cloud, destination=destination, network=network)
+
+
+def get_app() -> typer.Typer:
+    app = typer.Typer(add_completion=False, no_args_is_help=True, help="☁️ Cloud management commands")
+
+    app.command(name="sync", no_args_is_help=True, short_help="🔄 [s] Synchronize files/folders between local and cloud storage.")(sync)
+    app.command(name="s", no_args_is_help=True, hidden=True)(sync)
+
+    app.command(name="copy", no_args_is_help=True, short_help="📤 [c] Upload or 📥 Download files/folders to/from cloud storage.")(copy)
+    app.command(name="c", no_args_is_help=True, hidden=True)(copy)
+
+    app.command(name="mount", no_args_is_help=True, short_help="🔗 [m] Mount cloud storage services as local drives.")(mount)
+    app.command(name="m", no_args_is_help=True, hidden=True)(mount)
 
     return app