Unify documentation rules across languages and fix the Python template

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>

Python/prebuild.py

@@ -1,7 +1,9 @@
 import os
 import sys
 from pathlib import Path
+
 from dotenv import load_dotenv
+
 from src.constants import VERSION
 
 load_dotenv()
@@ -33,17 +35,20 @@ else:
 
 print(f"✓ Version: {VERSION}")
 
-env_debug = os.getenv("ENV_DEBUG", "false").lower() == "true"
-console_mode = env_debug
+env_debug = os.getenv("ENV_DEBUG", "false").lower() in ("true", "1", "yes")
+
+# console=True is the default — console tools rely on input() and print().
+# GUI applications turn it off with ENV_BUILD_CONSOLE=false in .env.
+console_mode = os.getenv("ENV_BUILD_CONSOLE", "true").lower() in ("true", "1", "yes")
 default_spec = Path(__file__).parent.name + ".spec"
 spec_filename = os.getenv("ENV_BUILD_SPEC", default_spec)
 
 print(f"\n{'-' * 50}")
 print("BUILD SETTINGS")
 print(f"{'-' * 50}")
-print(f"ENV_DEBUG:     {env_debug}")
-print(f"Console mode:  {console_mode}")
-print(f"Spec file:     {spec_filename}")
+print(f"ENV_DEBUG:          {env_debug}")
+print(f"ENV_BUILD_CONSOLE:  {console_mode}")
+print(f"Spec file:          {spec_filename}")
 
 spec_path = Path(__file__).parent / spec_filename
 if spec_path.exists():