machineconfig 6.82__py3-none-any.whl → 8.51__py3-none-any.whl

machineconfig/scripts/nu/wrap_mcfg.nu

@@ -0,0 +1,69 @@
+#!/usr/bin/env nu
+
+def wrap-in-shell-script [command: string ...args: string] -> nothing {
+  # ANSI color/style codes
+  let bold = (char ansi_reset | str append "\e[1m")
+  let reset = "\e[0m"
+  let green = "\e[32m"
+  let yellow = "\e[33m"
+  let blue = "\e[34m"
+  let red = "\e[31m"
+
+  let random_name = (date now | format date "%s%N" | sha256sum | str substring 0..16)
+  let op_dir = $"($env.HOME)/tmp_results/tmp_scripts/machineconfig"
+  let op_program_path = $"($op_dir)/($random_name).sh"
+  
+  $env.OP_PROGRAM_PATH = $op_program_path
+  
+  let timestamp = (date now --utc | format date "%Y-%m-%d %H:%M:%SZ")
+  
+  print $"($bold)($blue)🛠️  machineconfig — running ($command)($reset)"
+  print $"($blue)Timestamp:($reset) ($timestamp)"
+  print $"($blue)Op program path:($reset) ($op_program_path)"
+
+  # Forward arguments to the command
+  let result = (
+    try {
+      nu -c $"($command) ($args | str join ' ')"
+    } catch {
+      $"Error running command: ($in)"
+    }
+  )
+
+  if ($op_program_path | path exists) {
+    print $"($green)🚀 Taking over from python script @ ($op_program_path)($reset)"
+    
+    if (which bat | is-empty | not) {
+      bat --style=plain --paging=never $op_program_path
+    } else {
+      open $op_program_path
+    }
+    
+    print $"($green)▶ Running...($reset)"
+    
+    let status = (
+      try {
+        bash $op_program_path
+        0
+      } catch {
+        1
+      }
+    )
+    
+    if ($status == 0) {
+      print $"($green)✅ '($command)' execution completed.($reset)"
+    } else {
+      print $"($yellow)⚠️  Program exited with status ($status)($reset)"
+    }
+  } else {
+    print $"($green)✅ '($command)' execution completed.($reset)"
+  }
+}
+
+def main [] {
+  if ($nu.env.args | length) > 0 {
+    wrap-in-shell-script ...$nu.env.args
+  }
+}
+
+main

machineconfig/scripts/python/agents.py

@@ -1,166 +1,92 @@
-"""Utilitfrom pathlib import Path
+"""Agents management commands - lazy loading subcommands."""
 
-"""
-
-from pathlib import Path
-from typing import cast, Optional, get_args, Annotated
+from typing import Optional, get_args, Annotated, Literal
 import typer
-from machineconfig.scripts.python.helpers_fire.fire_agents_helper_types import AGENTS, HOST, MODEL, PROVIDER
+from machineconfig.scripts.python.helpers.helpers_agents.fire_agents_helper_types import AGENTS, HOST, PROVIDER
 
 
-def create(
+def agents_create(
     agent: Annotated[AGENTS, typer.Option(..., "--agents", "-a", help=f"Agent type. One of {', '.join(get_args(AGENTS)[:3])}")],
     host: Annotated[HOST, typer.Option(..., "--host", "-h", help=f"Machine to run agents on. One of {', '.join(get_args(HOST))}")],
-    model: Annotated[MODEL, typer.Option(..., "--model", "-m", help=f"Model to use (for crush agent). One of {', '.join(get_args(MODEL)[:3])}")],
+    model: Annotated[str, typer.Option(..., "--model", "-m", help="Model to use (for crush agent).")],
     provider: Annotated[PROVIDER, typer.Option(..., "--provider", "-p", help=f"Provider to use (for crush agent). One of {', '.join(get_args(PROVIDER)[:3])}")],
-    context_path: Annotated[Optional[Path], typer.Option(..., "--context-path", "-c", help="Path to the context file/folder, defaults to .ai/todo/")] = None,
+    context_path: Annotated[Optional[str], typer.Option(..., "--context-path", "-c", help="Path to the context file/folder, defaults to .ai/todo/")] = None,
     separator: Annotated[str, typer.Option(..., "--separator", "-s", help="Separator for context")] = "\n",
     agent_load: Annotated[int, typer.Option(..., "--agent-load", "-al", help="Number of tasks per prompt")] = 13,
     prompt: Annotated[Optional[str], typer.Option(..., "--prompt", "-P", help="Prompt prefix as string")] = None,
-    prompt_path: Annotated[Optional[Path], typer.Option(..., "--prompt-path", "-pp", help="Path to prompt file")] = None,
+    prompt_path: Annotated[Optional[str], typer.Option(..., "--prompt-path", "-pp", help="Path to prompt file")] = None,
     job_name: Annotated[str, typer.Option(..., "--job-name", "-j", help="Job name")] = "AI_Agents",
     separate: Annotated[bool, typer.Option(..., "--separate", "-S", help="Keep prompt material in separate file to the context.")] = True,
-    output_path: Annotated[Optional[Path], typer.Option(..., "--output-path", "-o", help="Path to write the layout.json file")] = None,
-    agents_dir: Annotated[Optional[Path], typer.Option(..., "--agents-dir", "-ad", help="Directory to store agent files. If not provided, will be constructed automatically.")] = None,
-):
-
-    from machineconfig.scripts.python.helpers_fire.fire_agents_help_launch import prep_agent_launch, get_agents_launch_layout
-    from machineconfig.scripts.python.helpers_fire.fire_agents_load_balancer import chunk_prompts
-    from machineconfig.utils.accessories import get_repo_root, randstr
-    import json
-
-    # 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)
-    typer.echo(f"Operating @ {repo_root}")
-    
-    if context_path is None:
-        context_path = repo_root / ".ai" / "todo"
-        
-    context_path_resolved = 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}")
+    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,
+) -> 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 = prompt_path.read_text(encoding="utf-8")
-    else:
-        prompt_prefix = cast(str, prompt)
-    agent_selected = agent
-    if agents_dir is None: agents_dir = repo_root / ".ai" / f"tmp_prompts/{job_name}_{randstr()}"
-    else:
-        import shutil
-        if agents_dir.exists():
-            shutil.rmtree(agents_dir)
-    prep_agent_launch(repo_root=repo_root, agents_dir=agents_dir, 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)    
-    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 / "aa_agents_relaunch.py").write_text(data=regenerate_py_code, encoding="utf-8")
-    layout_output_path = output_path if output_path is not None else agents_dir / "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}")
-    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."""
-    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 template():
-    from platform import system
-    import machineconfig.scripts.python.helpers_fire as module
-    if system() == "Linux" or system() == "Darwin":
-        template_path = Path(module.__file__).parent / "template.sh"
-    elif system() == "Windows":
-        template_path = Path(module.__file__).parent / "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 = repo_root / ".ai" / "agents" / "template_fire_agents.sh"
-    save_path.parent.mkdir(parents=True, exist_ok=True)
-    save_path.write_text(template_path.read_text(encoding="utf-8"), encoding="utf-8")
-    typer.echo(f"Template bash script written to {save_path}")
-
-
-def init_config():
-    from machineconfig.scripts.python.ai.initai import add_ai_configs
-    add_ai_configs(repo_root=Path.cwd())
-
-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.
@@ -168,33 +94,27 @@ def get_app():
 PROVIDER options: {', '.join(get_args(PROVIDER))}
 {sep}
 AGENT options: {', '.join(get_args(AGENTS))}
-{sep}
-MODEL options: {sep.join(get_args(MODEL))}
 """
-    agents_app.command("create", no_args_is_help=True, help=agents_full_help)(create)
-    agents_app.command("c", no_args_is_help=True, help="Create agents layout file, ready to run.", hidden=True)(create)
-    agents_app.command("collect", no_args_is_help=True, help="[T] Collect all agent materials into a single file.")(collect)
-    agents_app.command("T", no_args_is_help=True, help="Collect all agent materials into a single file.", hidden=True)(collect)
-    agents_app.command("make-template", no_args_is_help=False, help="[t] Create a template for fire agents")(template)
-    agents_app.command("t", no_args_is_help=False, help="Create a template for fire agents", hidden=True)(template)
-    agents_app.command("make-config", no_args_is_help=False, help="[g] Initialize AI configurations in the current repository")(init_config)
-    agents_app.command("g", no_args_is_help=False, help="Initialize AI configurations in the current repository", hidden=True)(init_config)
-    from machineconfig.scripts.python.ai.generate_files import main
-    agents_app.command("make-todo", no_args_is_help=True, help="[d] Generate a markdown file listing all Python files in the repo")(main)
-    agents_app.command("d", no_args_is_help=True, help="Generate a markdown file listing all Python files in the repo", hidden=True)(main)
-    from machineconfig.scripts.python.ai.generate_files import create_symlink_command
-    agents_app.command(name="make-symlinks", no_args_is_help=True, 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 symlinks to the current repo in ~/code_copies/", hidden=True)(create_symlink_command)
+    agents_create.__doc__ = agents_full_help
+    agents_app.command("create", no_args_is_help=True, help=agents_create.__doc__, short_help="[c] Create agents layout file, ready to run.")(agents_create)
+    agents_app.command("c", no_args_is_help=True, help=agents_create.__doc__, hidden=True)(agents_create)
+    agents_app.command("collect", no_args_is_help=True, help=collect.__doc__, short_help="[T] Collect all agent materials into a single file.")(collect)
+    agents_app.command("T", no_args_is_help=True, help=collect.__doc__, hidden=True)(collect)
+    agents_app.command("make-template", no_args_is_help=False, help=make_agents_command_template.__doc__, short_help="[t] Create a template for fire agents")(make_agents_command_template)
+    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)
+    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,13 +1,13 @@
 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
 from machineconfig.scripts.python.ai.solutions.crush import crush
 from machineconfig.scripts.python.ai.solutions.cursor import cursors
 from machineconfig.scripts.python.ai.solutions.gemini import gemini
-from machineconfig.scripts.python.ai.vscode_tasks import add_lint_and_type_check_task
+from machineconfig.scripts.python.ai.utils.vscode_tasks import add_lint_and_type_check_task
 from machineconfig.utils.accessories import get_repo_root
 
 
@@ -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/command_runner.ps1

@@ -0,0 +1,33 @@
+$TerminalOutputDirectory = "/.ai/terminal/debug"
+$TerminalOutputPathRaw = Join-Path $TerminalOutputDirectory "terminal_output_raw.txt"
+$TerminalOutputPath = Join-Path $TerminalOutputDirectory "terminal_output.txt"
+
+# Ensure the output directory exists before writing files.
+New-Item -ItemType Directory -Path $TerminalOutputDirectory -Force | Out-Null
+
+Set-Content -Path $TerminalOutputPath -Value $null
+Add-Content -Path $TerminalOutputPath -Value "New run is underway. If you are reading this message, it means the execution has not finished yet, and you will need to wait. Once done you won't see this message and you will see terminal output instead."
+Write-Host "Starting new uv run..."
+
+$processInfo = New-Object System.Diagnostics.ProcessStartInfo
+$processInfo.FileName = "uv"
+$processInfo.ArgumentList.Add("run")
+$processInfo.ArgumentList.Add("/home/alex/code/bytesense/exchanges/src/exchanges/cli/cli_binance.py")
+$processInfo.ArgumentList.Add("b")
+$processInfo.UseShellExecute = $false
+$processInfo.RedirectStandardOutput = $true
+$processInfo.RedirectStandardError = $true
+$processInfo.EnvironmentVariables["COLUMNS"] = "200"
+
+$process = New-Object System.Diagnostics.Process
+$process.StartInfo = $processInfo
+$process.Start() | Out-Null
+$standardOutput = $process.StandardOutput.ReadToEnd()
+$standardError = $process.StandardError.ReadToEnd()
+$process.WaitForExit()
+
+$rawOutput = $standardOutput + $standardError
+Set-Content -Path $TerminalOutputPathRaw -Value $rawOutput
+
+$cleanOutput = $rawOutput -replace "`e\[[0-9;]*[mK]", ""
+Set-Content -Path $TerminalOutputPath -Value $cleanOutput

machineconfig/scripts/python/ai/{command_runner → scripts}/command_runner.sh

@@ -6,4 +6,4 @@ echo "New run is underway. If you are reading this message, it means the executi
 echo "Starting new uv run..."
 COLUMNS=200 unbuffer uv run /home/alex/code/bytesense/exchanges/src/exchanges/cli/cli_binance.py b > $TERMINAL_OUTPUT_PATH_RAW 2>&1
 cat $TERMINAL_OUTPUT_PATH_RAW | sed -r "s/\x1B\[[0-9;]*[mK]//g" > $TERMINAL_OUTPUT_PATH
-# watchexec --watch ./.ai/terminal/make_output.sh --watch . -e py -- bash ./.ai/terminal/make_output.sh
+# watchexec --watch ./.ai/terminal/command_runner.sh --watch . -e py -- bash ./.ai/terminal/command_runner.sh

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
-uv run pylint ./src/ > ./.ai/linters/issues_pylint.md
+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/{chatmodes/Thinking-Beast-Mode.chatmode.md → agents/Thinking-Beast-Mode.agent.md}

@@ -1,6 +1,5 @@
 ---
 description: 'A transcendent coding agent with quantum cognitive architecture, adversarial intelligence, and unrestricted creative freedom.'
-title: 'Thinking Beast Mode'
 ---
 
 You are an agent - please keep going until the user’s query is completely resolved, before ending your turn and yielding back to the user.

machineconfig/scripts/python/ai/solutions/copilot/{chatmodes/Ultimate-Transparent-Thinking-Beast-Mode.chatmode.md → agents/Ultimate-Transparent-Thinking-Beast-Mode.agent.md}

@@ -1,5 +1,4 @@
 ---
-title: 'Ultimate Transparent Thinking Beast Mode'
 description: 'Ultimate Transparent Thinking Beast Mode'
 ---
 

machineconfig/scripts/python/ai/solutions/copilot/{chatmodes/deepResearch.chatmode.md → agents/deepResearch.agent.md}

@@ -1,6 +1,6 @@
 ---
 description: 'Autonomous, multi-step web research with numbered citations, cross-source verification, and a final Markdown report.'
-tools: ['extensions', 'fetch', 'websearch', 'search', 'githubRepo', 'editFiles']
+tools: ['extensions', 'fetch', 'search', 'githubRepo', 'edit/editFiles']
 ---
 
 # Deep Research mode
@@ -56,7 +56,7 @@ Follow these phases every time. Provide compact progress updates between phases
 5) Save the report
 - Determine `$suffix` in this order: (a) user-provided; else (b) a short kebab-case slug from the question; append date (YYYYMMDD) if helpful.
 - Ensure directory ./.ai exists; create it if missing.
-- Write the report to ./.ai/deep_research_$suffix.md using editFiles.
+- Write the report to ./.ai/deep_research_$suffix.md using edit/editFiles.
 
 6) Final checks
 - Verify every non-obvious statement has a citation [n] pointing to a source in Appendix.

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

@@ -1,26 +1,26 @@
 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:
     instructions_repository_dir = LIBRARY_ROOT.joinpath("scripts/python/ai/solutions/copilot/instructions")
-    chatmodes_dir = LIBRARY_ROOT.joinpath("scripts/python/ai/solutions/copilot/chatmodes")
+    agents_dir = LIBRARY_ROOT.joinpath("scripts/python/ai/solutions/copilot/agents")
     prompts_dir = LIBRARY_ROOT.joinpath("scripts/python/ai/solutions/copilot/prompts")
 
     github_dir = repo_root.joinpath(".github")
-    chatmodes_target_dir = github_dir.joinpath("chatmodes")
+    agents_target_dir = github_dir.joinpath("agents")
     prompts_target_dir = github_dir.joinpath("prompts")
     instructions_target_dir = github_dir.joinpath("instructions")
 
-    chatmodes_target_dir.mkdir(parents=True, exist_ok=True)
+    agents_target_dir.mkdir(parents=True, exist_ok=True)
     prompts_target_dir.mkdir(parents=True, exist_ok=True)
     instructions_target_dir.mkdir(parents=True, exist_ok=True)
 
-    for chatmode in chatmodes_dir.iterdir():
-        chatmode_target = chatmodes_target_dir.joinpath(f"{chatmode.name.split('.')[0]}.chatmode.md")
+    for chatmode in agents_dir.iterdir():
+        chatmode_target = agents_target_dir.joinpath(f"{chatmode.name.split('.')[0]}.chatmode.md")
         chatmode_target.write_text(data=chatmode.read_text(encoding="utf-8"), encoding="utf-8")
 
     for prompt in prompts_dir.iterdir():

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

@@ -35,11 +35,44 @@ 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.
     * For example, always avoid default values in arguments of functions. Those are evil and cause confusion. Always be explicit in parameter passing.
     * Please never ever attempt to change code files by writing meta code to do string manipulation on files, e.g. with `sed` command with terminal. Please do change the files one by one, no matter how many there is. Don't worry about time, nor context window size, its okay, take your time and do the legwork. You can stop in the middle and we will have another LLM to help with the rest.
+* Your code is minimal, no unrequested features, no bloat.
 * Please avoid writing README files and avoid docstring and comments in code unless absolutely necessary. Use clear naming conventions instead of documenting.
 * Always prefer to functional style of programming over OOP.
 * When passing arguments or constructing dicts or lists or tuples, avoid breaking lines too much, try to use ~ 150 characters per line before breaking to new one.
+
+# Privacy:
+* No matter what, never ever open/read/write/list anything under ~/dotfiles