Repository hygiene + STATUS diagram render fixes

.githooks/pre-push

@@ -0,0 +1,20 @@
+#!/usr/bin/env bash
+set -euo pipefail
+
+remote_name="${1:-}"
+current_branch="$(git rev-parse --abbrev-ref HEAD)"
+
+# Prevent server-side protected-branch push failures with a clear local message.
+if [[ "$current_branch" == "main" && "$remote_name" == "origin" && "${ALLOW_MAIN_PUSH:-}" != "1" ]]; then
+  cat <<'MSG' >&2
+Blocked push to origin/main.
+Use protected-branch workflow:
+1) git switch -c <branch-name>
+2) git push -u origin <branch-name>
+3) open a PR to main
+
+To bypass once, run:
+ALLOW_MAIN_PUSH=1 git push origin main
+MSG
+  exit 1
+fi

docs/ROADMAP.md

@@ -1,6 +1,6 @@
 # ROADMAP
 
-BatLLM is approaching 1.0 as a stable local desktop product. The current 0.2.x line already includes the core game loop, session saving, replay analysis, cross-platform launchers, and Ollama integration, so the remaining work for 1.0 is product consistency, reliability, and release hardening.
+BatLLM is approaching 1.0 as a stable local desktop product. The current 0.3.x line already includes the core game loop, session saving, replay analysis, cross-platform launchers, and Ollama integration, so the remaining work for 1.0 is product consistency, reliability, and release hardening.
 
 Version 2.0 is the planned architecture shift. It should focus on networked play first, then use that foundation to support additional clients and shared content.
 

run_batllm.py

@@ -1,6 +1,7 @@
 """Cross-platform launcher for BatLLM."""
 
 from __future__ import annotations
+from util.compat import require_supported_python
 
 import sys
 from pathlib import Path
@@ -11,7 +12,6 @@
 if str(SRC) not in sys.path:
     sys.path.insert(0, str(SRC))
 
-from util.compat import require_supported_python
 
 require_supported_python("BatLLM")
 

run_game_analyzer.py

@@ -1,6 +1,7 @@
 """Cross-platform launcher for the standalone BatLLM Game Analyzer."""
 
 from __future__ import annotations
+from util.compat import require_supported_python
 
 import sys
 from pathlib import Path
@@ -11,7 +12,6 @@
 if str(SRC) not in sys.path:
     sys.path.insert(0, str(SRC))
 
-from util.compat import require_supported_python
 
 require_supported_python("BatLLM Game Analyzer")
 

run_tests.py

@@ -1,6 +1,7 @@
 """Cross-platform test runner for BatLLM."""
 
 from __future__ import annotations
+from util.compat import require_supported_python
 
 import argparse
 import os
@@ -13,12 +14,10 @@
 VENV_PYTHON = (
     ROOT / ".venv_BatLLM" / ("Scripts/python.exe" if os.name == "nt" else "bin/python")
 )
-OLLAMA_HELPER = ROOT / "src" / "ollama_service.py"
 
 if str(SRC) not in sys.path:
     sys.path.insert(0, str(SRC))
 
-from util.compat import require_supported_python
 
 def build_parser() -> argparse.ArgumentParser:
     """Create the CLI argument parser."""

src/configs/config-llama.yaml

@@ -19,8 +19,8 @@ llm:
   num_ctx: 4096
   path: /api/chat
   port: 11434
-  system_instructions_augmented_independent: src/headers/system_instructions/augmented_independent_1.txt
-  system_instructions_augmented_shared: src/headers/system_instructions/augmented_shared_1.txt
+  system_instructions_augmented_independent: src/assets/system_instructions/augmented_independent_1.txt
+  system_instructions_augmented_shared: src/assets/system_instructions/augmented_shared_1.txt
   system_instructions_not_augmented_independent: src/assets/system_instructions/not_augmented_independent_1.txt
   system_instructions_not_augmented_shared: src/assets/system_instructions/not_augmented_shared_1.txt
   url: http://localhost