dsh-office-kit 0.3.0 → 0.3.2

package/assets/skills/office-presentations/container_tools/create_montage.py

@@ -13,6 +13,13 @@ import json
 import sys
 from pathlib import Path
 
+# Windows consoles default to a legacy code page; every payload is UTF-8 JSON.
+for _stream in (sys.stdout, sys.stderr):
+    try:
+        _stream.reconfigure(encoding="utf-8", errors="replace")
+    except (AttributeError, ValueError):
+        pass
+
 try:
     from PIL import Image, ImageDraw, ImageFont
 except ImportError:  # pragma: no cover - whitelist dependency, but fail clearly

package/assets/skills/office-presentations/container_tools/inspect_presentation_layout_geometry.py

@@ -42,6 +42,13 @@ from ooxml_helpers import (  # noqa: E402
     text_of,
 )
 
+# Windows consoles default to a legacy code page; every payload is UTF-8 JSON.
+for _stream in (sys.stdout, sys.stderr):
+    try:
+        _stream.reconfigure(encoding="utf-8", errors="replace")
+    except (AttributeError, ValueError):
+        pass
+
 TITLE_OUTSIDE_MARGIN_IN = 0.0
 DEFAULT_TITLE_FLOOR_PT = 28.0
 DEFAULT_BODY_FLOOR_PT = 14.0

package/assets/skills/office-presentations/container_tools/inspect_presentation_package_integrity.py

@@ -16,6 +16,13 @@ import zipfile
 from pathlib import Path
 from xml.etree import ElementTree
 
+# Windows consoles default to a legacy code page; every payload is UTF-8 JSON.
+for _stream in (sys.stdout, sys.stderr):
+    try:
+        _stream.reconfigure(encoding="utf-8", errors="replace")
+    except (AttributeError, ValueError):
+        pass
+
 REL_NS = "{http://schemas.openxmlformats.org/package/2006/relationships}"
 CT_NS = "{http://schemas.openxmlformats.org/package/2006/content-types}"
 P_NS = "{http://schemas.openxmlformats.org/presentationml/2006/main}"

package/assets/skills/office-presentations/container_tools/native_chart_title_gate.py

@@ -20,6 +20,13 @@ import zipfile
 from pathlib import Path
 from xml.etree import ElementTree
 
+# Windows consoles default to a legacy code page; every payload is UTF-8 JSON.
+for _stream in (sys.stdout, sys.stderr):
+    try:
+        _stream.reconfigure(encoding="utf-8", errors="replace")
+    except (AttributeError, ValueError):
+        pass
+
 sys.path.insert(0, str(Path(__file__).resolve().parent))
 
 C_NS = "{http://schemas.openxmlformats.org/drawingml/2006/chart}"

package/assets/skills/office-presentations/container_tools/native_quantitative_chart_gate.py

@@ -22,6 +22,13 @@ from decimal import Decimal, InvalidOperation
 from pathlib import Path
 from xml.etree import ElementTree
 
+# Windows consoles default to a legacy code page; every payload is UTF-8 JSON.
+for _stream in (sys.stdout, sys.stderr):
+    try:
+        _stream.reconfigure(encoding="utf-8", errors="replace")
+    except (AttributeError, ValueError):
+        pass
+
 sys.path.insert(0, str(Path(__file__).resolve().parent))
 
 C_NS = "{http://schemas.openxmlformats.org/drawingml/2006/chart}"

package/assets/skills/office-presentations/container_tools/native_table_arithmetic_gate.py

@@ -24,6 +24,13 @@ import sys
 from decimal import Decimal, InvalidOperation
 from pathlib import Path
 
+# Windows consoles default to a legacy code page; every payload is UTF-8 JSON.
+for _stream in (sys.stdout, sys.stderr):
+    try:
+        _stream.reconfigure(encoding="utf-8", errors="replace")
+    except (AttributeError, ValueError):
+        pass
+
 sys.path.insert(0, str(Path(__file__).resolve().parent))
 
 TOTAL_PATTERN = re.compile(r"\btotal\b", re.IGNORECASE)

package/assets/skills/office-presentations/container_tools/ooxml_helpers.py

@@ -23,6 +23,13 @@ import sys
 from pathlib import Path
 from typing import Any, Iterable, Iterator
 
+# Windows consoles default to a legacy code page; every payload is UTF-8 JSON.
+for _stream in (sys.stdout, sys.stderr):
+    try:
+        _stream.reconfigure(encoding="utf-8", errors="replace")
+    except (AttributeError, ValueError):
+        pass
+
 EMU_PER_INCH = 914400
 
 # Anything that renders about a full em wide and wraps mid-token.

package/assets/skills/office-presentations/container_tools/preview_render.py

@@ -48,6 +48,13 @@ from ooxml_helpers import (  # noqa: E402
     WIDE_CHAR,
 )
 
+# Windows consoles default to a legacy code page; every payload is UTF-8 JSON.
+for _stream in (sys.stdout, sys.stderr):
+    try:
+        _stream.reconfigure(encoding="utf-8", errors="replace")
+    except (AttributeError, ValueError):
+        pass
+
 INK = (0.13, 0.15, 0.18)
 MUTED = (0.42, 0.45, 0.50)
 RULE = (0.80, 0.82, 0.85)

package/assets/skills/office-presentations/container_tools/render_slides.py

@@ -23,6 +23,13 @@ import sys
 import tempfile
 from pathlib import Path
 
+# Windows consoles default to a legacy code page; every payload is UTF-8 JSON.
+for _stream in (sys.stdout, sys.stderr):
+    try:
+        _stream.reconfigure(encoding="utf-8", errors="replace")
+    except (AttributeError, ValueError):
+        pass
+
 sys.path.insert(0, str(Path(__file__).resolve().parent))
 
 

package/assets/skills/office-presentations/container_tools/replace_text.py

@@ -26,6 +26,13 @@ import json
 import sys
 from pathlib import Path
 
+# Windows consoles default to a legacy code page; every payload is UTF-8 JSON.
+for _stream in (sys.stdout, sys.stderr):
+    try:
+        _stream.reconfigure(encoding="utf-8", errors="replace")
+    except (AttributeError, ValueError):
+        pass
+
 
 def _emit(payload: dict, code: int = 0) -> int:
     print(json.dumps(payload, ensure_ascii=False, indent=2))

package/assets/skills/office-presentations/container_tools/template_source_fidelity_gate.py

@@ -30,6 +30,13 @@ sys.path.insert(0, str(Path(__file__).resolve().parent))
 
 from ooxml_helpers import box, is_picture, slide_size_in  # noqa: E402
 
+# Windows consoles default to a legacy code page; every payload is UTF-8 JSON.
+for _stream in (sys.stdout, sys.stderr):
+    try:
+        _stream.reconfigure(encoding="utf-8", errors="replace")
+    except (AttributeError, ValueError):
+        pass
+
 EMU_PER_INCH = 914400
 DEFAULT_TOLERANCE_EMU = 9144  # 0.01 in
 

package/assets/skills/office-presentations/template_following_scripts/check_template_fidelity.py

@@ -20,6 +20,13 @@ sys.path.insert(0, str(Path(__file__).resolve().parent.parent / "container_tools
 
 from ooxml_helpers import box, has_visible_text, is_picture, overlap_ratio, text_of  # noqa: E402
 
+# Windows consoles default to a legacy code page; every payload is UTF-8 JSON.
+for _stream in (sys.stdout, sys.stderr):
+    try:
+        _stream.reconfigure(encoding="utf-8", errors="replace")
+    except (AttributeError, ValueError):
+        pass
+
 PLACEHOLDER_PATTERNS = [
     re.compile(pattern, re.IGNORECASE)
     for pattern in (

package/assets/skills/office-presentations/template_following_scripts/inspect_template_deck.py

@@ -23,6 +23,13 @@ sys.path.insert(0, str(Path(__file__).resolve().parent.parent / "container_tools
 
 from ooxml_helpers import box, has_visible_text, is_chart, is_picture, is_table, placeholder_kind, slide_size_in, text_of  # noqa: E402
 
+# Windows consoles default to a legacy code page; every payload is UTF-8 JSON.
+for _stream in (sys.stdout, sys.stderr):
+    try:
+        _stream.reconfigure(encoding="utf-8", errors="replace")
+    except (AttributeError, ValueError):
+        pass
+
 
 def _theme(presentation) -> dict:
     fonts: set[str] = set()

package/assets/skills/office-presentations/template_following_scripts/make_contact_sheet.py

@@ -15,6 +15,13 @@ import math
 import sys
 from pathlib import Path
 
+# Windows consoles default to a legacy code page; every payload is UTF-8 JSON.
+for _stream in (sys.stdout, sys.stderr):
+    try:
+        _stream.reconfigure(encoding="utf-8", errors="replace")
+    except (AttributeError, ValueError):
+        pass
+
 sys.path.insert(0, str(Path(__file__).resolve().parent.parent / "container_tools"))
 
 

package/assets/skills/office-presentations/template_following_scripts/prepare_template_starter_deck.py

@@ -23,6 +23,13 @@ sys.path.insert(0, str(Path(__file__).resolve().parent.parent / "container_tools
 
 from ooxml_helpers import box, placeholder_kind, slide_size_in  # noqa: E402
 
+# Windows consoles default to a legacy code page; every payload is UTF-8 JSON.
+for _stream in (sys.stdout, sys.stderr):
+    try:
+        _stream.reconfigure(encoding="utf-8", errors="replace")
+    except (AttributeError, ValueError):
+        pass
+
 PLACEHOLDER_ALIASES = {
     "title": ("TITLE", "CENTER_TITLE"),
     "subtitle": ("SUBTITLE",),

package/assets/skills/office-presentations/template_following_scripts/validate_template_plan.py

@@ -26,6 +26,13 @@ import json
 import sys
 from pathlib import Path
 
+# Windows consoles default to a legacy code page; every payload is UTF-8 JSON.
+for _stream in (sys.stdout, sys.stderr):
+    try:
+        _stream.reconfigure(encoding="utf-8", errors="replace")
+    except (AttributeError, ValueError):
+        pass
+
 sys.path.insert(0, str(Path(__file__).resolve().parent.parent / "container_tools"))
 
 ALLOWED_ACTIONS = {"rewrite", "rewrite-and-reposition", "replace", "delete", "keep", "fill-placeholder"}

package/assets/skills/office-spreadsheets/container_tools/add_chart.py

@@ -35,6 +35,13 @@ import json
 import sys
 from pathlib import Path
 
+# Windows consoles default to a legacy code page; every payload is UTF-8 JSON.
+for _stream in (sys.stdout, sys.stderr):
+    try:
+        _stream.reconfigure(encoding="utf-8", errors="replace")
+    except (AttributeError, ValueError):
+        pass
+
 if hasattr(sys.stdout, "reconfigure"):
     sys.stdout.reconfigure(errors="replace")
 

package/assets/skills/office-spreadsheets/container_tools/add_image.py

@@ -23,6 +23,13 @@ import json
 import sys
 from pathlib import Path
 
+# Windows consoles default to a legacy code page; every payload is UTF-8 JSON.
+for _stream in (sys.stdout, sys.stderr):
+    try:
+        _stream.reconfigure(encoding="utf-8", errors="replace")
+    except (AttributeError, ValueError):
+        pass
+
 if hasattr(sys.stdout, "reconfigure"):
     sys.stdout.reconfigure(errors="replace")
 

package/assets/skills/office-spreadsheets/container_tools/append_rows.py

@@ -29,6 +29,13 @@ import json
 import sys
 from pathlib import Path
 
+# Windows consoles default to a legacy code page; every payload is UTF-8 JSON.
+for _stream in (sys.stdout, sys.stderr):
+    try:
+        _stream.reconfigure(encoding="utf-8", errors="replace")
+    except (AttributeError, ValueError):
+        pass
+
 if hasattr(sys.stdout, "reconfigure"):
     sys.stdout.reconfigure(errors="replace")
 

package/assets/skills/office-spreadsheets/container_tools/diff_workbooks.py

@@ -21,6 +21,13 @@ import json
 import sys
 from pathlib import Path
 
+# Windows consoles default to a legacy code page; every payload is UTF-8 JSON.
+for _stream in (sys.stdout, sys.stderr):
+    try:
+        _stream.reconfigure(encoding="utf-8", errors="replace")
+    except (AttributeError, ValueError):
+        pass
+
 if hasattr(sys.stdout, "reconfigure"):
     # Legacy console codepages (cp936, cp1252) must not abort a report.
     sys.stdout.reconfigure(errors="replace")

package/assets/skills/office-spreadsheets/container_tools/inspect_workbook.py

@@ -22,6 +22,13 @@ import sys
 import zipfile
 from pathlib import Path
 
+# Windows consoles default to a legacy code page; every payload is UTF-8 JSON.
+for _stream in (sys.stdout, sys.stderr):
+    try:
+        _stream.reconfigure(encoding="utf-8", errors="replace")
+    except (AttributeError, ValueError):
+        pass
+
 if hasattr(sys.stdout, "reconfigure"):
     # Legacy console codepages (cp936, cp1252) must not abort a report.
     sys.stdout.reconfigure(errors="replace")

package/assets/skills/office-spreadsheets/container_tools/recalc_gate.py

@@ -28,6 +28,13 @@ import subprocess
 import sys
 from pathlib import Path
 
+# Windows consoles default to a legacy code page; every payload is UTF-8 JSON.
+for _stream in (sys.stdout, sys.stderr):
+    try:
+        _stream.reconfigure(encoding="utf-8", errors="replace")
+    except (AttributeError, ValueError):
+        pass
+
 if hasattr(sys.stdout, "reconfigure"):
     # Legacy console codepages (cp936, cp1252) must not abort a report.
     sys.stdout.reconfigure(errors="replace")
@@ -116,23 +123,28 @@ def _referenced_sheets(formula: str) -> list[str]:
     return found
 
 
-def _recalculate(python: str, cli: Path, source: Path, out: Path) -> tuple[bool, str | None]:
+def _recalculate(python: str, cli: Path, source: Path, out: Path) -> tuple[bool, str | None, str | None]:
     command = [python, str(cli), "xlsx", "recalc", "--input", str(source), "--out", str(out)]
     try:
         completed = subprocess.run(command, capture_output=True, text=True, timeout=300)
     except FileNotFoundError as error:
-        return False, f"cannot start the helper CLI: {error}"
+        return False, f"cannot start the helper CLI: {error}", None
     except subprocess.TimeoutExpired:
-        return False, "recalculation timed out after 300 seconds"
+        return False, "recalculation timed out after 300 seconds", None
     if completed.returncode == 0 and out.is_file():
-        return True, None
+        renderer = None
+        try:
+            renderer = json.loads(completed.stdout).get("renderer")
+        except (json.JSONDecodeError, AttributeError):
+            renderer = None
+        return True, None, renderer
     message = (completed.stderr or completed.stdout or "").strip()
     try:
         parsed = json.loads(message)
         message = str(parsed.get("error", message))
     except json.JSONDecodeError:
         pass
-    return False, message or f"helper CLI exited with code {completed.returncode}"
+    return False, message or f"helper CLI exited with code {completed.returncode}", None
 
 
 def _ignored(entries: str | None) -> dict[str, set[str]]:
@@ -176,10 +188,10 @@ def main() -> int:
         if not cli.is_file():
             recalc_error = f"helper CLI not found: {cli}; pass --cli or use --no-recalc"
         else:
-            recalculated, recalc_error = _recalculate(args.python, cli, source, out)
+            recalculated, recalc_error, renderer = _recalculate(args.python, cli, source, out)
             if recalculated:
                 checked = out
-                engine = "microsoft excel"
+                engine = renderer or "recalculation engine"
 
     try:
         cached = _cached_values(checked, cells) if cells else {}

package/assets/skills/office-spreadsheets/container_tools/set_cells.py

@@ -26,6 +26,13 @@ import json
 import sys
 from pathlib import Path
 
+# Windows consoles default to a legacy code page; every payload is UTF-8 JSON.
+for _stream in (sys.stdout, sys.stderr):
+    try:
+        _stream.reconfigure(encoding="utf-8", errors="replace")
+    except (AttributeError, ValueError):
+        pass
+
 if hasattr(sys.stdout, "reconfigure"):
     sys.stdout.reconfigure(errors="replace")
 

package/assets/skills/office-spreadsheets/container_tools/sheet_ops.py

@@ -24,6 +24,13 @@ import json
 import sys
 from pathlib import Path
 
+# Windows consoles default to a legacy code page; every payload is UTF-8 JSON.
+for _stream in (sys.stdout, sys.stderr):
+    try:
+        _stream.reconfigure(encoding="utf-8", errors="replace")
+    except (AttributeError, ValueError):
+        pass
+
 if hasattr(sys.stdout, "reconfigure"):
     sys.stdout.reconfigure(errors="replace")
 

package/assets/skills/office-spreadsheets/container_tools/style_cells.py

@@ -30,6 +30,13 @@ import json
 import sys
 from pathlib import Path
 
+# Windows consoles default to a legacy code page; every payload is UTF-8 JSON.
+for _stream in (sys.stdout, sys.stderr):
+    try:
+        _stream.reconfigure(encoding="utf-8", errors="replace")
+    except (AttributeError, ValueError):
+        pass
+
 if hasattr(sys.stdout, "reconfigure"):
     sys.stdout.reconfigure(errors="replace")
 

package/assets/skills/shared/check_runtime.py

@@ -24,6 +24,13 @@ import subprocess
 import sys
 from pathlib import Path
 
+# Windows consoles default to a legacy code page; every payload is UTF-8 JSON.
+for _stream in (sys.stdout, sys.stderr):
+    try:
+        _stream.reconfigure(encoding="utf-8", errors="replace")
+    except (AttributeError, ValueError):
+        pass
+
 DEFAULT_ROOT = Path(__file__).resolve().parents[3]
 RENDERER_HINT = (
     "docx/pptx/xlsx rendering needs LibreOffice, Microsoft Office, or WPS Office; "

package/dist/index.js

@@ -280,18 +280,13 @@ function statusOf(python) {
 		remedy: runtimeRemedy()
 	};
 }
-/** Inspect every candidate; return the first interpreter that proves it has all dependencies. */
-async function inspectRuntime(configFile = officePaths().configFile) {
-	let compatible;
-	let last;
-	for (const candidate of [...candidates(configFile), ...await launcherInterpreters()]) for (const expanded of await expandLauncher(candidate)) {
-		if (expanded !== candidate && !isFile(expanded)) continue;
-		const inspection = await inspectPython(expanded);
-		if (inspection.compatible && inspection.missing.length === 0) return statusOf(inspection);
-		if (inspection.compatible && compatible == null) compatible = inspection;
-		last = inspection;
-	}
+/** Pick the best interpreter: all dependencies first, then compatible-only, else none. */
+function selectRuntime(inspections) {
+	const ready = inspections.find((inspection) => inspection.compatible && inspection.missing.length === 0);
+	if (ready != null) return statusOf(ready);
+	const compatible = inspections.find((inspection) => inspection.compatible);
 	if (compatible != null) return statusOf(compatible);
+	const last = inspections[inspections.length - 1];
 	return {
 		state: "no-interpreter",
 		packages: [],
@@ -300,6 +295,17 @@ async function inspectRuntime(configFile = officePaths().configFile) {
 		...last?.error == null ? {} : { error: last.error }
 	};
 }
+/** Inspect candidates in priority order; the first fully-provisioned interpreter wins. */
+async function inspectRuntime(configFile = officePaths().configFile) {
+	const seen = [];
+	for (const candidate of [...candidates(configFile), ...await launcherInterpreters()]) for (const expanded of await expandLauncher(candidate)) {
+		if (expanded !== candidate && !isFile(expanded)) continue;
+		const inspection = await inspectPython(expanded);
+		seen.push(inspection);
+		if (inspection.compatible && inspection.missing.length === 0) return selectRuntime(seen);
+	}
+	return selectRuntime(seen);
+}
 /** Run postinstall.mjs as a child process; resolve with an error summary or undefined. */
 function runPostinstall() {
 	return new Promise((resolve) => {
@@ -324,20 +330,27 @@ function runPostinstall() {
 }
 let cache;
 let healing;
+/** A cached `ok` is only worth reusing while its interpreter still exists on disk. */
+function runtimeAlive(status) {
+	return status.state !== "ok" || status.python != null && isFile(status.python.path);
+}
 /**
 * Resolve a runtime that is proven to work, self-healing via postinstall.mjs when it
 * is missing or incomplete. Never returns a bare interpreter without dependencies.
+* Pass `force` for an explicit status check that must not trust the process cache.
 */
-function ensureRuntime(configFile = officePaths().configFile) {
-	if (cache != null && (cache.status.state === "ok" || Date.now() - cache.at < FAILURE_RETRY_DELAY)) return Promise.resolve(cache.status);
+function ensureRuntime(configFile = officePaths().configFile, force = false) {
+	if (!force && cache != null) {
+		if (cache.status.state === "ok" ? runtimeAlive(cache.status) : Date.now() - cache.at < FAILURE_RETRY_DELAY) return Promise.resolve(cache.status);
+	}
 	healing ??= (async () => {
-		const fresh = await inspectRuntime(configFile);
-		if (fresh.state === "ok") {
+		const probed = await inspectRuntime(configFile);
+		if (probed.state === "ok") {
 			cache = {
-				status: fresh,
+				status: probed,
 				at: Date.now()
 			};
-			return fresh;
+			return probed;
 		}
 		const healError = await runPostinstall();
 		const status = {
@@ -519,7 +532,7 @@ function apply(ctx) {
 		},
 		timeoutMs: 6e5,
 		async execute() {
-			const runtime = await ensureRuntime(paths.configFile);
+			const runtime = await ensureRuntime(paths.configFile, true);
 			const report = {
 				plugin: {
 					name,

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "dsh-office-kit",
   "type": "module",
-  "version": "0.3.0",
+  "version": "0.3.2",
   "description": "Office documents, PDF, presentations, and spreadsheets for DeepSeek Harness",
   "author": "Hairy",
   "license": "MIT",

package/postinstall.mjs

@@ -16,7 +16,7 @@
  */
 
 import { spawnSync } from 'node:child_process'
-import { existsSync, mkdirSync, readFileSync, rmSync, writeFileSync } from 'node:fs'
+import { existsSync, mkdirSync, readFileSync, realpathSync, rmSync, writeFileSync } from 'node:fs'
 import { homedir, tmpdir } from 'node:os'
 import { dirname, join } from 'node:path'
 import process from 'node:process'
@@ -25,15 +25,15 @@ import { fileURLToPath } from 'node:url'
 const PACKAGE_ROOT = dirname(fileURLToPath(import.meta.url))
 const IS_WINDOWS = process.platform === 'win32'
 const PYTHON_VERSION = '3.12.10'
-const RUNTIME_DIR = join(homedir(), '.dsh', 'office', 'runtime')
-const VENV_DIR = join(RUNTIME_DIR, 'venv')
+export const RUNTIME_DIR = join(homedir(), '.dsh', 'office', 'runtime')
+export const VENV_DIR = join(RUNTIME_DIR, 'venv')
 const VENV_PYTHON = join(VENV_DIR, IS_WINDOWS ? 'Scripts/python.exe' : 'bin/python')
 const LEGACY_DATA_DIR = IS_WINDOWS
   ? join(process.env.LOCALAPPDATA || join(homedir(), 'AppData', 'Local'), 'dsh-office-kit')
   : process.platform === 'darwin'
     ? join(homedir(), 'Library', 'Application Support', 'dsh-office-kit')
     : join(process.env.XDG_DATA_HOME || join(homedir(), '.local', 'share'), 'dsh-office-kit')
-const LEGACY_VENV_DIR = join(LEGACY_DATA_DIR, 'venv')
+export const LEGACY_VENV_DIR = join(LEGACY_DATA_DIR, 'venv')
 const LEGACY_VENV_PYTHON = join(LEGACY_VENV_DIR, IS_WINDOWS ? 'Scripts/python.exe' : 'bin/python')
 const CONFIG_DIR = join(process.env.APPDATA || join(homedir(), 'AppData', 'Roaming'), 'dsh-office-kit')
 const CONFIG_FILE = join(CONFIG_DIR, 'config.json')
@@ -181,6 +181,24 @@ function verifySignature(file) {
   }
 }
 
+/**
+ * Installer switches. PATH is appended by the installer itself (`AppendPath=1`),
+ * the install location stays the per-user default (no `TargetDir`), and the
+ * `py` launcher is kept so `py -3.12` works.
+ */
+export function installerArguments() {
+  return [
+    '/quiet',
+    'InstallAllUsers=0',
+    'AppendPath=1',
+    'CompileAll=0',
+    'Include_test=0',
+    'Include_doc=0',
+    'Include_pip=1',
+    'SimpleInstall=1',
+  ]
+}
+
 function installPython() {
   if (!IS_WINDOWS) {
     return false
@@ -191,17 +209,7 @@ function installPython() {
   download(url, installer)
   verifySignature(installer)
   log(`installing Python ${PYTHON_VERSION} into the installer default per-user location`)
-  const args = [
-    '/quiet',
-    'InstallAllUsers=0',
-    'AppendPath=1',
-    'CompileAll=0',
-    'Include_test=0',
-    'Include_doc=0',
-    'Include_pip=1',
-    'SimpleInstall=1',
-  ]
-  const result = spawnSync(installer, args, { stdio: 'inherit', timeout: 15 * 60 * 1000 })
+  const result = spawnSync(installer, installerArguments(), { stdio: 'inherit', timeout: 15 * 60 * 1000 })
   rmSync(installer, { force: true })
   if (result.status !== 0) {
     throw new Error(`Python installer exited with status ${result.status}`)
@@ -368,6 +376,21 @@ function readPackageVersion() {
   }
 }
 
-const started = Date.now()
-main()
-log(`finished in ${((Date.now() - started) / 1000).toFixed(1)}s`)
+function startedFromCli() {
+  const entry = process.argv[1]
+  if (entry == null) {
+    return false
+  }
+  try {
+    return realpathSync(entry) === realpathSync(fileURLToPath(import.meta.url))
+  }
+  catch {
+    return false
+  }
+}
+
+if (startedFromCli()) {
+  const started = Date.now()
+  main()
+  log(`finished in ${((Date.now() - started) / 1000).toFixed(1)}s`)
+}