rinkplanner/AGENTS.md
torsten 7bbd8c9c1d fix: Release-Härtung, JSON-Dateiformat und Quality-Meilenstein
- Export: Runtime-Bridge-Autoload und Skater-GLB samt Texturen einschließen, Editor-Addons ausschließen
- tools/check_export.sh als headless Smoke-Test; ./tools/test.sh --export
- RoutineFile: JSON-Format, atomare Saves, Whitelist für Legacy-.tres
- Überschreibschutz für Speichern unter/Export, Session- und Autosave-Restore
- Globaler Delete-Shortcut blockiert bei offenen Dialogen
- Sync akzeptiert .json und Legacy-.tres, Konfliktnamen behalten die Endung
- Tests für Dateiformat, Überschreiben, Session und Legacy-Schutz
- Quality-Meilenstein mit 'Als Nächstes' und 'Danach' in der Roadmap
2026-11-03 23:48:01 +01:00

45 lines
2.3 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters

This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

# 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.