feat: generate env.bat for Windows CMD and restricted PowerShell environments

Author: codemedic

README.md

@@ -59,6 +59,18 @@ source ~/.claude/redmatter/python/env.sh
 . "$env:USERPROFILE\.claude\redmatter\python\env.ps1"
 ```
 
+> [!NOTE]
+> If your system blocks PowerShell scripts (`running scripts is disabled on this system`), use
+> `install.bat` instead of `install.ps1`, and source the environment with `call` instead of dot-sourcing:
+>
+> ```bat
+> install.bat -Prefix "%USERPROFILE%\.claude\redmatter\python" -MinPython "3.10" -UvEnv "REDMATTER_UV" -PythonEnv "REDMATTER_PYTHON"
+> call "%USERPROFILE%\.claude\redmatter\python\env.bat"
+> ```
+>
+> To remove the restriction permanently, run in an elevated PowerShell prompt:
+> `Set-ExecutionPolicy -Scope CurrentUser RemoteSigned`
+
 **Scripted install (quiet mode):**
 
 ```bash
@@ -116,6 +128,7 @@ exec "$PYTHON" script.py
     Scripts/python.exe        # Windows
   env.sh                      # exports env vars + conditional PATH (bash)
   env.ps1                     # exports env vars + conditional PATH (PowerShell)
+  env.bat                     # exports env vars + conditional PATH (CMD / restricted PS)
   distro.toml                 # source version record + [install] options
 ```
 

setup.py

@@ -208,6 +208,39 @@ def _write_env_ps1(prefix: Path, uv_env: str, python_env: str, distro_version: s
     _ok("env.ps1")
 
 
+# ── env.bat ───────────────────────────────────────────────────────────────────
+
+def _write_env_bat(prefix: Path, uv_env: str, python_env: str, distro_version: str) -> None:
+    if not _IS_WINDOWS:
+        return
+
+    uv_exe  = prefix / "uv.exe"
+    venv_py = prefix / "venv" / "Scripts" / "python.exe"
+    bin_dir = prefix / "bin"
+
+    add_to_path, notes = _path_decision(bin_dir)
+
+    lines: list[str] = [
+        f"@echo off",
+        f":: managed-python v{distro_version} -- generated by setup.py",
+        ":: Do not edit manually; re-run install to regenerate",
+        "",
+        ":: Env vars (always set -- these are the reliable contract)",
+        f'SET {uv_env}={uv_exe}',
+        f'SET {python_env}={venv_py}',
+        "",
+    ]
+
+    if add_to_path:
+        lines += [f":: {n}" for n in notes]
+        lines.append(f'SET PATH={bin_dir};%PATH%')
+    else:
+        lines += [f":: {n}" for n in notes]
+
+    (prefix / "env.bat").write_text("\r\n".join(lines) + "\r\n", encoding="utf-8")
+    _ok("env.bat")
+
+
 # ── distro.toml ───────────────────────────────────────────────────────────────
 
 def _write_installed_distro_toml(
@@ -299,6 +332,7 @@ def main() -> None:
     _create_bin(prefix)
     _write_env_sh(prefix, args.uv_env, args.python_env, distro_version)
     _write_env_ps1(prefix, args.uv_env, args.python_env, distro_version)
+    _write_env_bat(prefix, args.uv_env, args.python_env, distro_version)
     _write_installed_distro_toml(
         script_dir, prefix, args.min_python, args.uv_env, args.python_env, args.shell_profile
     )
@@ -312,6 +346,7 @@ def main() -> None:
         print()
         if _IS_WINDOWS:
             print(f'  . "{prefix / "env.ps1"}"')
+            print(f'  or (if scripts are restricted):  call "{prefix / "env.bat"}"')
         else:
             print(f'  source "{prefix / "env.sh"}"')
         print()