machineconfig 5.15__py3-none-any.whl → 7.98__py3-none-any.whl

machineconfig/scripts/python/agents.py

@@ -2,44 +2,33 @@
 
 """
 
-from pathlib import Path
-from typing import cast, Iterable, Optional, get_args
+from typing import cast, Optional, get_args, Annotated
 import typer
-from machineconfig.scripts.python.fire_agents_helper_types import AGENTS
-
-
-def _write_list_file(target: Path, files: Iterable[Path]) -> None:
-    target.parent.mkdir(parents=True, exist_ok=True)
-    target.write_text("\n".join(str(f) for f in files), encoding="utf-8")
+from machineconfig.scripts.python.helpers_agents.fire_agents_helper_types import AGENTS, HOST, PROVIDER
 
 
 def create(
-    context_path: Optional[Path] = typer.Option(None, help="Path to the context file"),
-    keyword_search: Optional[str] = typer.Option(None, help="Keyword to search in Python files"),
-    filename_pattern: Optional[str] = typer.Option(None, help="Filename pattern to match"),
-    separator: str = typer.Option("\n", help="Separator for context"),
-    tasks_per_prompt: int = typer.Option(13, help="Number of tasks per prompt"),
-    agent: AGENTS = typer.Option(..., help=f"Agent type. One of {', '.join(get_args(AGENTS))}"),
-    prompt: Optional[str] = typer.Option(None, help="Prompt prefix as string"),
-    prompt_path: Optional[Path] = typer.Option(None, help="Path to prompt file"),
-    job_name: str = typer.Option("AI_Agents", help="Job name"),
-    keep_separate: bool = typer.Option(True, help="Keep prompt material in separate file to the context."),
-    output_path: Optional[Path] = typer.Option(None, help="Path to write the layout.json file"),
-    agents_dir: Optional[Path] = typer.Option(None, help="Directory to store agent files. If not provided, will be constructed automatically."),
+    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[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[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[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[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.fire_agents_help_launch import prep_agent_launch, get_agents_launch_layout
-    from machineconfig.scripts.python.fire_agents_help_search import search_files_by_pattern, search_python_files
-    from machineconfig.scripts.python.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
-    context_options = [context_path, keyword_search, filename_pattern]
-    provided_context = [opt for opt in context_options if opt is not None]
-    if len(provided_context) != 1:
-        raise typer.BadParameter("Exactly one of --context-path, --keyword-search, --filename-pattern must be provided")
-    
     prompt_options = [prompt, prompt_path]
     provided_prompt = [opt for opt in prompt_options if opt is not None]
     if len(provided_prompt) != 1:
@@ -49,80 +38,73 @@ 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}")
     
-    search_strategy = ""
-    prompt_material_path = Path("")
+    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 is not None:
-        search_strategy = "file_path"
-        target_file_path = context_path.expanduser().resolve()
-        if not target_file_path.exists() or not target_file_path.is_file():
-            raise typer.BadParameter(f"Invalid file path: {target_file_path}")
-        prompt_material_path = target_file_path
-    elif keyword_search is not None:
-        search_strategy = "keyword_search"
-        matching_files = search_python_files(repo_root, keyword_search)
-        if not matching_files:
-            typer.echo(f"💥 No .py files found containing keyword: {keyword_search}")
-            raise typer.Exit(1)
-        target_file_path = repo_root / ".ai" / "target_file.txt"
-        _write_list_file(target_file_path, matching_files)
-        prompt_material_path = target_file_path
-    elif filename_pattern is not None:
-        search_strategy = "filename_pattern"
-        matching_files = search_files_by_pattern(repo_root, filename_pattern)
-        if not matching_files:
-            typer.echo(f"💥 No files found matching pattern: {filename_pattern}")
-            raise typer.Exit(1)
-        target_file_path = repo_root / ".ai" / "target_file.txt"
-        _write_list_file(target_file_path, matching_files)
-        prompt_material_path = target_file_path
+    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}")
     
     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
-    keep_material_in_separate_file_input = keep_separate
-    prompt_material_re_splitted = chunk_prompts(prompt_material_path, tasks_per_prompt=tasks_per_prompt, joiner=separator)
-    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(agents_dir=agents_dir, prompts_material=prompt_material_re_splitted, keep_material_in_separate_file=keep_material_in_separate_file_input, prompt_prefix=prompt_prefix, agent=agent_selected, job_name=job_name)
-    layoutfile = get_agents_launch_layout(session_root=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.13 --with machineconfig
-#!/usr/bin/env uv run --no-dev --project $HOME/code/machineconfig
-fire_agents create --context-path "{prompt_material_path}" \\
-    --{search_strategy} "{context_path or keyword_search or filename_pattern}" \\
+#!/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}" \\
-    --tasks-per-prompt {tasks_per_prompt} \\
+    --agent_load {agent_load} \\
     --separator "{separator}" \\
-    {"--keep-separate" if keep_material_in_separate_file_input else ""}
+    {"--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"
+    (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}")
 
 
 def collect(
-    agent_dir: Path = typer.Argument(..., help="Path to the agent directory containing the prompts folder"),
-    output_path: Path = typer.Argument(..., help="Path to write the concatenated material files"),
-    separator: str = typer.Option("\n", help="Separator to use when concatenating material files"),
+    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 agent_dir.exists() or not agent_dir.is_dir():
+    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 = agent_dir / "prompts"
+    prompts_dir = Path(agent_dir) / "prompts"
     if not prompts_dir.exists():
         raise typer.BadParameter(f"Prompts directory not found: {prompts_dir}")
     
@@ -149,36 +131,20 @@ def collect(
     result = separator.join(concatenated_content)
     
     # Write to output file
-    output_path.parent.mkdir(parents=True, exist_ok=True)
-    output_path.write_text(result, encoding="utf-8")
+    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():
-    template_bash = """#!/bin/bash
-JOB_NAME="outpatient_mapping"
-REPO_ROOT="$HOME/code/work/winter_planning/"
-CONTEXT_PATH="$REPO_ROOT/data/outpatient_mapping/op_services_collected.csv"
-PROMPT_PATH="$REPO_ROOT/data/outpatient_mapping/prompt"
-
-AGENTS_DIR="$REPO_ROOT/.ai/agents/$JOB_NAME"
-LAYOUT_PATH="$REPO_ROOT/.ai/agents/$JOB_NAME/layout_unbalanced.json"
-LAYOUT_BALANCED_PATH="$REPO_ROOT/.ai/agents/$JOB_NAME/layout_balanced.json"
-
-agents create --context-path $CONTEXT_PATH --tasks-per-prompt 10 --agent crush --prompt-path $PROMPT_PATH --keep-separate --output-path $LAYOUT_PATH --agents-dir $AGENTS_DIR
-sessions balance-load $LAYOUT_PATH --max-thresh 6 --breaking-method moreLayouts --thresh-type number  --output-path $LAYOUT_BALANCED_PATH
-
-sessions run $LAYOUT_BALANCED_PATH --kill-upon-completion
-agents collect $AGENTS_DIR "$REPO_ROOT/.ai/agents/$JOB_NAME/collected.txt"
-"""
-    template_powershell = """
-
-"""
+def make_agents_command_template():
     from platform import system
-    if system() == "Linux":
-        template = template_bash
+    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 = template_powershell
+        template_path = Path(module.__file__).parent / "templates/template.ps1"
     else:
         raise typer.BadParameter(f"Unsupported OS: {system()}")
 
@@ -187,22 +153,62 @@ agents collect $AGENTS_DIR "$REPO_ROOT/.ai/agents/$JOB_NAME/collected.txt"
     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, encoding="utf-8")
-    typer.echo(f"Template bash script written to {save_path}")
-
-
-def main_from_parser():
-    import sys
-    agents_app = typer.Typer(help="🤖 AI Agents management subcommands")
-    agents_app.command("create")(create)
-    agents_app.command("collect")(collect)
-    agents_app.command("template")(template)
-    if len(sys.argv) == 1:
-        agents_app(["--help"])
-    else:
-        agents_app()
+
+    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():
+    from machineconfig.scripts.python.ai.initai import add_ai_configs
+    from pathlib import Path
+    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)
+    sep = "\n"
+    agents_full_help = f"""
+[c] Create agents layout file, ready to run.
+{sep}
+PROVIDER options: {', '.join(get_args(PROVIDER))}
+{sep}
+AGENT options: {', '.join(get_args(AGENTS))}
+"""
+    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")(make_agents_command_template)
+    agents_app.command("t", no_args_is_help=False, help="Create a template for fire agents", hidden=True)(make_agents_command_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.utils.generate_files import make_todo_files
+    agents_app.command("make-todo", no_args_is_help=True, 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="Generate a markdown file listing all Python files in the repo", 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="[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)
+    return agents_app
+
+
+def main():
+    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

machineconfig/scripts/python/ai/initai.py

@@ -7,6 +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.utils.vscode_tasks import add_lint_and_type_check_task
 from machineconfig.utils.accessories import get_repo_root
 
 
@@ -14,25 +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
-
-"""
-            import subprocess
-
-            subprocess.run(command_to_run, shell=True, check=True)
-        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")
@@ -40,6 +22,8 @@ uv add --upgrade-package pytest --dev
     generic.create_dot_scripts(repo_root=repo_root)
     generic.adjust_gitignore(repo_root=repo_root)
 
+    add_lint_and_type_check_task(repo_root=repo_root)
+
     github_copilot.build_configuration(repo_root=repo_root)
     cursors.build_configuration(repo_root=repo_root)
     gemini.build_configuration(repo_root=repo_root)
@@ -47,12 +31,3 @@ uv add --upgrade-package pytest --dev
     crush.build_configuration(repo_root=repo_root)
     cline.build_configuration(repo_root=repo_root)
 
-
-
-def main() -> None:
-    repo_root = Path.cwd()
-    add_ai_configs(repo_root=repo_root)
-
-
-if __name__ == "__main__":
-    add_ai_configs(repo_root=Path.cwd())

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/scripts/command_runner.sh

@@ -0,0 +1,9 @@
+#!/bin/bash
+TERMINAL_OUTPUT_PATH_RAW="/.ai/terminal/debug/terminal_output_raw.txt"
+TERMINAL_OUTPUT_PATH="/.ai/terminal/debug/terminal_output.txt"
+> $TERMINAL_OUTPUT_PATH
+echo "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." >> $TERMINAL_OUTPUT_PATH
+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/command_runner.sh --watch . -e py -- bash ./.ai/terminal/command_runner.sh

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

@@ -66,9 +66,8 @@ uv run -m cleanpy .
 uv run -m ruff clean
 # uv run -m ruff format .
 uv run -m ruff check . --fix
-uv run --no-dev --project $HOME/code/machineconfig -m machineconfig.scripts.python.ai.generate_files
 
-New-Item -ItemType Directory -Force -Path .linters | Out-Null
+New-Item -ItemType Directory -Force -Path .ai/linters | Out-Null
 
 Write-Host "${GREEN}🧹 Code cleanup complete!${NC}"
 Write-Host
@@ -78,38 +77,38 @@ Draw-Box "🔍 TYPE CHECKERS & LINTERS 🔍" "${BOLD}${PURPLE}"
 $CURRENT_STEP++
 Draw-Progress $CURRENT_STEP $TOTAL_STEPS "Pyright Type Checker"
 Write-Host "${BLUE}📋 Analyzing types with Pyright...${NC}"
-Remove-Item ./.linters/pyright_result.md -ErrorAction SilentlyContinue
-uv run pyright . | Out-File -FilePath ./.linters/pyright_result.md
-Write-Host "${GREEN}✅ Results saved to ${UNDERLINE}./.linters/pyright_result.md${NC}"
+Remove-Item ./.ai/linters/issues_pyright.md -ErrorAction SilentlyContinue
+uv run pyright . | Out-File -FilePath ./.ai/linters/issues_pyright.md
+Write-Host "${GREEN}✅ Results saved to ${UNDERLINE}./.ai/linters/issues_pyright.md${NC}"
 
 $CURRENT_STEP++
 Draw-Progress $CURRENT_STEP $TOTAL_STEPS "MyPy Type Checker"
 Write-Host "${BLUE}📋 Analyzing types with MyPy...${NC}"
-Remove-Item ./.linters/mypy_result.md -ErrorAction SilentlyContinue
-uv run mypy . | Out-File -FilePath ./.linters/mypy_result.md
-Write-Host "${GREEN}✅ Results saved to ${UNDERLINE}./.linters/mypy_result.md${NC}"
+Remove-Item ./.ai/linters/issues_mypy.md -ErrorAction SilentlyContinue
+uv run mypy . | Out-File -FilePath ./.ai/linters/issues_mypy.md
+Write-Host "${GREEN}✅ Results saved to ${UNDERLINE}./.ai/linters/issues_mypy.md${NC}"
 
 $CURRENT_STEP++
 Draw-Progress $CURRENT_STEP $TOTAL_STEPS "Pylint Code Analysis"
 Write-Host "${BLUE}📋 Analyzing code quality with Pylint...${NC}"
-Remove-Item ./.linters/pylint_result.md -ErrorAction SilentlyContinue
-uv run pylint ./src/ | Out-File -FilePath ./.linters/pylint_result.md
-Write-Host "${GREEN}✅ Results saved to ${UNDERLINE}./.linters/pylint_result.md${NC}"
+Remove-Item ./.ai/linters/issues_pylint.md -ErrorAction SilentlyContinue
+uv run pylint ./src/ | Out-File -FilePath ./.ai/linters/issues_pylint.md
+Write-Host "${GREEN}✅ Results saved to ${UNDERLINE}./.ai/linters/issues_pylint.md${NC}"
 
 $CURRENT_STEP++
 Draw-Progress $CURRENT_STEP $TOTAL_STEPS "Pyrefly Type Checker"
 Write-Host "${BLUE}📋 Analyzing types with Pyrefly...${NC}"
-Remove-Item ./.linters/pyrefly_result.md -ErrorAction SilentlyContinue
-uv run pyrefly check . | Out-File -FilePath ./.linters/pyrefly_result.md
-Write-Host "${GREEN}✅ Results saved to ${UNDERLINE}./.linters/pyrefly_result.md${NC}"
+Remove-Item ./.ai/linters/issues_pyrefly.md -ErrorAction SilentlyContinue
+uv run pyrefly check . | Out-File -FilePath ./.ai/linters/issues_pyrefly.md
+Write-Host "${GREEN}✅ Results saved to ${UNDERLINE}./.ai/linters/issues_pyrefly.md${NC}"
 
 $CURRENT_STEP++
 Draw-Progress $CURRENT_STEP $TOTAL_STEPS "Ruff Linter"
 Write-Host "${BLUE}📋 Checking code style with Ruff...${NC}"
-Remove-Item ./.linters/ruff_result.md -ErrorAction SilentlyContinue
-uv run ruff check . | Out-File -FilePath ./.linters/ruff_result.md
-Write-Host "${GREEN}✅ Results saved to ${UNDERLINE}./.linters/ruff_result.md${NC}"
+Remove-Item ./.ai/linters/issues_ruff.md -ErrorAction SilentlyContinue
+uv run ruff check . | Out-File -FilePath ./.ai/linters/issues_ruff.md
+Write-Host "${GREEN}✅ Results saved to ${UNDERLINE}./.ai/linters/issues_ruff.md${NC}"
 
 Write-Host
 Draw-Box "🎉 ALL CHECKS COMPLETED! 🎉" "${BOLD}${GREEN}"
-Write-Host "${BOLD}${GREEN}📁 Check the ${UNDERLINE}.linters${NC}${BOLD}${GREEN} directory for detailed results.${NC}"
+Write-Host "${BOLD}${GREEN}📁 Check the ${UNDERLINE}.ai/linters${NC}${BOLD}${GREEN} directory for detailed results.${NC}"

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

@@ -70,9 +70,8 @@ uv run -m cleanpy .
 uv run -m ruff clean
 # uv run -m ruff format .
 uv run -m ruff check . --fix
-uv run --no-dev --project $HOME/code/machineconfig -m machineconfig.scripts.python.ai.generate_files
 
-mkdir .linters
+mkdir .ai/linters
 
 echo -e "${GREEN}🧹 Code cleanup complete!${NC}"
 echo
@@ -82,38 +81,38 @@ 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 ./.linters/pyright_result.md || true
-uv run pyright . > ./.linters/pyright_result.md
-echo -e "${GREEN}✅ Results saved to ${UNDERLINE}./.linters/pyright_result.md${NC}"
+rm ./.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 ./.linters/mypy_result.md || true
-uv run mypy . > ./.linters/mypy_result.md
-echo -e "${GREEN}✅ Results saved to ${UNDERLINE}./.linters/mypy_result.md${NC}"
+rm ./.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 ./.linters/pylint_result.md || true
-uv run pylint ./src/ > ./.linters/pylint_result.md
-echo -e "${GREEN}✅ Results saved to ${UNDERLINE}./.linters/pylint_result.md${NC}"
+rm ./.ai/linters/issues_pylint.md || true
+uv run pylint ./src/ > ./.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 ./.linters/pyrefly_result.md || true
-uv run pyrefly check . > ./.linters/pyrefly_result.md
-echo -e "${GREEN}✅ Results saved to ${UNDERLINE}./.linters/pyrefly_result.md${NC}"
+rm ./.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 ./.linters/ruff_result.md || true
-uv run ruff check . > ./.linters/ruff_result.md
-echo -e "${GREEN}✅ Results saved to ${UNDERLINE}./.linters/ruff_result.md${NC}"
+rm ./.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}"
 
 echo
 draw_box "🎉 ALL CHECKS COMPLETED! 🎉" "${BOLD}${GREEN}"
-echo -e "${BOLD}${GREEN}📁 Check the ${UNDERLINE}.linters${NC}${BOLD}${GREEN} directory for detailed results.${NC}"
+echo -e "${BOLD}${GREEN}📁 Check the ${UNDERLINE}.ai/linters${NC}${BOLD}${GREEN} directory for detailed results.${NC}"

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

@@ -2,4 +2,12 @@ from pathlib import Path
 from machineconfig.utils.source_of_truth import LIBRARY_ROOT
 
 def get_generic_instructions_path() -> Path:
-    return LIBRARY_ROOT.joinpath("scripts/python/ai/solutions/copilot/instructions/python/dev.instructions.md")
+    path = LIBRARY_ROOT.joinpath("scripts/python/ai/solutions/copilot/instructions/python/dev.instructions.md")
+    text = path.read_text(encoding="utf-8")
+    import platform
+    if platform.system().lower() == "windows":
+        text = text.replace("bash", "powershell").replace(".sh", ".ps1")
+    import tempfile
+    temp_path = Path(tempfile.gettempdir()).joinpath("generic_instructions.md")
+    temp_path.write_text(data=text, encoding="utf-8")
+    return temp_path

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():