# Hinweise für Agenten ## macOS-Testbuild veröffentlichen Beim Hochladen eines macOS-Builds auf den Webspace (programmschmiede.de): - Neben der App-ZIP (`rinkplanner.zip`) auch `start_rinkplanner.command` mit hochladen und auf der Startseite verlinken. - **Das Start-Skript nicht zippen** – es wird direkt als `.command` abgelegt und verlinkt. (Stand 2026-10-31 so vom Nutzer gewünscht.) - Download-Links relativ zur `index.html` setzen, z. B. `rinkplanner/download/rinkplanner.zip`. ## Dateiformat und Release-Check - Neue Kürdateien werden als JSON gespeichert (`RoutineFile`). `.tres` ist nur noch Legacy-Import und wird vor dem Laden per Whitelist geprüft; nicht wieder als neues Speicherformat einführen. - Vor einem Release `./tools/check_export.sh` laufen lassen. Es baut den Linux-Export, startet ihn headless und prüft Autoload, Testausschluss und die Skater-Texturen. Die GLB muss vorher per `tools/sync_assets.sh --sync` vorliegen. ## MCP-Werkzeuge - **Godot:** `godot-mcp` steuert das Projekt über `--project rinkplanner/rinkplanner`. Die Live-Editor-Werkzeuge brauchen das Addon `rinkplanner/addons/godot_ai_bridge` (Port 6550, startet mit dem Editor). - `godot_ai_bridge` ist eine Kopie aus `/opt/godot-mcp` **mit lokalem Patch**. Beim Neukopieren den Patch aus `docs/findings-2026-11-01-godot-ai-bridge.md` erneut anwenden, sonst meldet jeder `--import`-Lauf „6 ObjectDB instances leaked at exit". - **Blender:** `mcp-for-blender` über `uvx`, Addon in `~/.config/blender/5.2/scripts/addons/blender_mcp.py` (Port 9876). - **fal:** Remote-Server `https://mcp.fal.ai/mcp-relay` (Streamable HTTP) mit `Authorization: Bearer {env:FAL_KEY}` in `opencode.jsonc`. Kein OAuth nötig – der Relay akzeptiert den API-Key als Bearer, der Browser-Login scheitert dagegen oft am lokalen Callback-Port. Der Key liegt in `~/.config/environment.d/90-fal.conf` (Modus 600), im systemd-Format; `~/.bashrc` sourct dieselbe Datei vor dem Interaktiv-Guard. Meldet fal `needs authentication`, fehlt dem OpenCode-Dienst die Variable: `systemctl --user import-environment FAL_KEY && opencode service restart`. Nach einer Key-Rotation ebenso: Datei anpassen, import-environment, Neustart. `run_model` und `submit_job` lösen kostenpflichtige Generierungen aus – vorher Modell und Preis nennen und die Zustimmung abwarten.