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

machineconfig/scripts/linux/wrap_mcfg

@@ -0,0 +1,46 @@
+#!/usr/bin/env bash
+
+
+wrap_in_shell_script() {
+  # set -euo pipefail
+  # ANSI color/style codes
+  # BOLD="\033[1m"
+  # RESET="\033[0m"
+  # GREEN="\033[32m"
+  # YELLOW="\033[33m"
+  # BLUE="\033[34m"
+  # RED="\033[31m"
+
+  local command="$1"
+  shift  
+  local RANDOM_NAME=$(LC_ALL=C tr -dc 'A-Za-z0-9' </dev/urandom | head -c 12)
+  local OP_DIR="$HOME/tmp_results/tmp_scripts/machineconfig"
+  local OP_PROGRAM_PATH="$OP_DIR/${RANDOM_NAME}.sh"
+  export OP_PROGRAM_PATH
+  # local timestamp=$(date -u +"%Y-%m-%d %H:%M:%SZ")
+  # printf "%b\n" "${BOLD}${BLUE}🛠️  machineconfig — running ${command}${RESET}"
+  # printf "%b\n" "${BLUE}Timestamp:${RESET} ${timestamp}"
+  # printf "%b\n" "${BLUE}Op program path:${RESET} ${OP_PROGRAM_PATH}"
+  # Forward arguments to the command
+  "$command" "$@"
+  if [[ -f "$OP_PROGRAM_PATH" ]]; then
+    printf "%b\n" "🚀 Taking over from python script @ ${OP_PROGRAM_PATH}${RESET}"
+    bat --style=full --theme=OneHalfDark --paging=never "$OP_PROGRAM_PATH"
+    # printf "%b\n" "${GREEN}▶ Running...${RESET}"
+    . "$OP_PROGRAM_PATH"
+    status=$?
+    # if [[ $status -eq 0 ]]; then
+      # printf "%b\n" "${GREEN}✅ '${command}' execution completed.${RESET}"
+    # else
+      # printf "%b\n" "${YELLOW}⚠️  Program exited with status ${status}${RESET}"
+    # fi
+  else
+    echo " "
+    # printf "%b\n" "${GREEN}✅ '${command}' execution completed.${RESET}"
+  fi
+}
+
+if [[ $# -gt 0 ]]; then
+  wrap_in_shell_script "$@"
+fi
+

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

@@ -2,33 +2,32 @@
 
 """
 
-from pathlib import Path
 from typing import cast, Optional, get_args, Annotated
 import typer
-from machineconfig.scripts.python.helpers_fire.fire_agents_helper_types import AGENTS, HOST, MODEL, PROVIDER
+from machineconfig.scripts.python.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,
+    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_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.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]
@@ -39,12 +38,13 @@ def create(
     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 = repo_root / ".ai" / "todo"
-        
-    context_path_resolved = context_path.expanduser().resolve()
+        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}")
     
@@ -60,36 +60,37 @@ def create(
         raise typer.BadParameter(f"Path is neither file nor directory: {context_path_resolved}")
     
     if prompt_path is not None:
-        prompt_prefix = prompt_path.read_text(encoding="utf-8")
+        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 = repo_root / ".ai" / f"tmp_prompts/{job_name}_{randstr()}"
+    if agents_dir is None: agents_dir_obj = Path(repo_root) / ".ai" / f"tmp_prompts/{job_name}_{randstr()}"
     else:
         import shutil
-        if agents_dir.exists():
+        if Path(agents_dir).exists():
             shutil.rmtree(agents_dir)
-    prep_agent_launch(repo_root=repo_root, agents_dir=agents_dir, prompts_material=prompt_material_re_splitted,
+        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)    
-    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"
+    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}")
+    typer.echo(f"Created agents in {agents_dir_obj}")
     typer.echo(f"Ceated layout in {layout_output_path}")
 
 
@@ -99,6 +100,7 @@ def collect(
     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}")
     
@@ -134,13 +136,16 @@ def collect(
     typer.echo(f"Concatenated material written to {output_path}")
 
 
-def template():
+def make_agents_command_template():
+    """Create a template for fire agents"""
     from platform import system
-    import machineconfig.scripts.python.helpers_fire as module
+    import machineconfig.scripts.python.helpers_agents as module
+    from pathlib import Path
+
     if system() == "Linux" or system() == "Darwin":
-        template_path = Path(module.__file__).parent / "template.sh"
+        template_path = Path(module.__file__).parent / "templates/template.sh"
     elif system() == "Windows":
-        template_path = Path(module.__file__).parent / "template.ps1"
+        template_path = Path(module.__file__).parent / "templates/template.ps1"
     else:
         raise typer.BadParameter(f"Unsupported OS: {system()}")
 
@@ -149,18 +154,36 @@ def template():
     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}")
 
+    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}")
 
-def init_config():
+    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
-    add_ai_configs(repo_root=Path.cwd())
+    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)
+    agents_app = typer.Typer(help="🤖 AI Agents management subcommands", no_args_is_help=True, add_help_option=False, add_completion=False)
     sep = "\n"
     agents_full_help = f"""
 [c] Create agents layout file, ready to run.
@@ -168,23 +191,22 @@ 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)
+    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)
     return agents_app
 
 

machineconfig/scripts/python/ai/initai.py

@@ -7,7 +7,7 @@ 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
 
 
@@ -15,24 +15,6 @@ def add_ai_configs(repo_root: Path) -> None:
     repo_root_resolved = get_repo_root(repo_root)
     if repo_root_resolved is not None:
         repo_root = repo_root_resolved  # this means you can run the command from any subdirectory of the repo.
-
-#     if repo_root.joinpath("pyproject.toml").exists() is False:
-#         uv_init = input(f"{repo_root} does not seem to be a python project (no pyproject.toml found), would you like to initialize one? (y/n) ")
-#         if uv_init.strip().lower() == "y":
-#             command_to_run = """
-# uv init --python 3.13
-# uv venv
-# uv add --upgrade-package pylint pyright mypy pyrefly ty --dev  # linters and type checkers
-# uv add --upgrade-package pytest --dev
-# uv add typer --dev
-
-# """
-#             from machineconfig.utils.code import run_shell_script
-#             run_shell_script(command_to_run)
-#         else:
-#             print("Terminating initai ...")
-#             return
-
     dot_ai_dir = repo_root.joinpath(".ai")
     dot_ai_dir.mkdir(parents=True, exist_ok=True)
     dot_scripts_dir = repo_root.joinpath(".scripts")

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.sh

@@ -96,7 +96,7 @@ echo -e "${GREEN}✅ Results saved to ${UNDERLINE}./.ai/linters/issues_mypy.md${
 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
+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++))

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

@@ -7,20 +7,20 @@ 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

@@ -40,6 +40,10 @@ applyTo: "**/*.py"
 * 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

machineconfig/scripts/python/ai/solutions/copilot/instructions/python/watch_exec.prompt.md

@@ -0,0 +1,20 @@
+
+
+* I have started a watch-exec server in my terminal and its working now.
+* I have set it up to re-run the shell script `.ai/terminal/debug/command_runner.sh` automatically.
+    * A re-run is triggered upon any change of any python file in the repo, or, any change in the command_runner.sh script itself.
+* The shell script itself runs the python file we are working on using uv.
+* The script redirects the output from terminal to the file ./.ai* Run takes 50 ms only. So by the time you finish editing any python file or the command runner script, the new output is ready for you to read in that text file.
+* Run takes 50 ms only. So by the time you finish editing any python file or the command runner script, the new output is ready for you to read in that text file.
+
+# Why did I set this up?
+* Because this makes it much faster for you to iterate because pulling the terminal and closing it every time is a bit slow.
+* You no longer need the terminal.
+
+
+# What should you do now?
+Please iterate like this:
+* Please use the terminal_output.txt as your main iteration driver (fix any problems you see there).
+* Change `command_runner.sh` if you need to change which python file to run or how to run it.
+
+

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

@@ -50,7 +50,7 @@ def adjust_gitignore(repo_root: Path) -> None:
         ".cursor",
         ".clinerules",
         ".github/instructions",
-        ".github/chatmodes",
+        ".github/agents",
         ".github/prompts",
     ]
 

machineconfig/scripts/python/ai/{generate_files.py → utils/generate_files.py}

@@ -247,7 +247,7 @@ def create_repo_symlinks(repo_root: Path) -> None:
         symlink_path.symlink_to(repo_root, target_is_directory=True)
 
 
-def main(
+def make_todo_files(
     pattern: Annotated[str, typer.Argument(help="Pattern or keyword to match files by")],
     repo: Annotated[str, typer.Argument(help="Repository path. Can be any directory within a git repository.")] = str(Path.cwd()),
     strategy: Annotated[Literal["name", "keywords"], typer.Option("-s", "--strategy", help="Strategy to filter files: 'name' for filename matching, 'keywords' for content matching")] = "name",
@@ -344,5 +344,5 @@ def create_symlink_command(num: Annotated[int, typer.Argument(help="Number of sy
     console.print(Panel(f"✅ SUCCESS | Created {num} symlinks to {repo_root} in ~/code_copies/", border_style="bold green", expand=False))
 
 if __name__ == "__main__":
-    typer.run(main)
+    typer.run(make_todo_files)
     # typer.run(create_symlink_command)

machineconfig/scripts/python/ai/{vscode_tasks.py → utils/vscode_tasks.py}

@@ -1,5 +1,6 @@
 import json
 from pathlib import Path
+from typing import Any
 
 
 def add_lint_and_type_check_task(repo_root: Path) -> None:
@@ -18,8 +19,12 @@ def add_lint_and_type_check_task(repo_root: Path) -> None:
     }
 
     if tasks_json_path.exists():
-        with tasks_json_path.open("r") as f:
-            tasks_config = json.load(f)
+        json_data = tasks_json_path.read_text(encoding="utf-8")
+        if not json_data.strip():
+            tasks_config: dict[str, Any] = {"version": "2.0.0", "tasks": []}
+        else:
+            tasks_config = json.loads(json_data)
+            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", [])}

machineconfig/scripts/python/cloud.py

@@ -1,20 +1,20 @@
 
 import typer
-from machineconfig.scripts.python.cloud_helpers.cloud_sync import main as sync_main
-from machineconfig.scripts.python.cloud_helpers.cloud_copy import main as copy_main
-from machineconfig.scripts.python.cloud_helpers.cloud_mount import mount as mount_main
+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
 
 def get_app():
     app = typer.Typer(add_completion=False, no_args_is_help=True)
 
-    app.command(name="sync", no_args_is_help=True, help="""🔄 [s] Synchronize files/folders between local and cloud storage.""")(sync_main)
-    app.command(name="s", no_args_is_help=True, hidden=True)(sync_main)  # short alias
+    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
 
-    app.command(name="copy", no_args_is_help=True, 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, hidden=True)(copy_main)  # short alias
+    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, 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, hidden=True)(mount_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
 
     return app
 
@@ -22,3 +22,8 @@ def get_app():
 def main():
     app = get_app()
     app()
+
+
+if __name__ == "__main__":
+    pass
+    # a = get_app()(asdf)