Add shared Black Belt CLI AI engine transport

Author: mearvk

bin/blackbelt-engine.sh

@@ -0,0 +1,43 @@
+#!/usr/bin/env bash
+set -euo pipefail
+
+# Shared Black Belt AI transport. The CLI front ends send canonical JSON here.
+# Default engine: Ollama on localhost. Override with BBEA_ENGINE_URL and BBEA_MODEL.
+ENGINE_URL="${BBEA_ENGINE_URL:-http://127.0.0.1:11434/api/generate}"
+MODEL="${BBEA_MODEL:-llama3.1:8b}"
+PROMPT_FILE="${BBEA_SYSTEM_PROMPT:-black.belt/sharp/system.prompt}"
+
+if [[ ! -f "$PROMPT_FILE" ]]; then
+  SCRIPT_DIR="$(cd -- "$(dirname -- "${BASH_SOURCE[0]}")" && pwd)"
+  ROOT="$(cd -- "$SCRIPT_DIR/.." && pwd)"
+  PROMPT_FILE="$ROOT/black.belt/sharp/system.prompt"
+fi
+
+if [[ ! -f "$PROMPT_FILE" ]]; then
+  echo "Black Belt system prompt not found: $PROMPT_FILE" >&2
+  exit 2
+fi
+
+INPUT="$(cat)"
+if [[ -z "${INPUT//[[:space:]]/}" ]]; then
+  echo "No JSON audit input received." >&2
+  exit 2
+fi
+
+python3 - "$PROMPT_FILE" "$MODEL" "$INPUT" <<'PY' | curl --fail-with-body -sS "$ENGINE_URL" -H 'Content-Type: application/json' --data-binary @-
+import json, pathlib, sys
+prompt_path, model, audit_input = sys.argv[1], sys.argv[2], sys.argv[3]
+system_prompt = pathlib.Path(prompt_path).read_text(encoding='utf-8')
+try:
+    parsed = json.loads(audit_input)
+except json.JSONDecodeError as exc:
+    raise SystemExit(f"Invalid audit JSON: {exc}")
+request = {
+    "model": model,
+    "system": system_prompt,
+    "prompt": json.dumps(parsed, ensure_ascii=False, separators=(",", ":")),
+    "stream": False,
+    "format": "json"
+}
+print(json.dumps(request, ensure_ascii=False))
+PY