kader bestanden toegevoegd

CHANGE_POLICY.md

@@ -0,0 +1,130 @@
+# CHANGE_POLICY.md
+
+Dit document bepaalt welke wijzigingen AI-agents zelfstandig mogen uitvoeren en welke wijzigingen expliciete toestemming vereisen.
+
+Doel:
+- ongewenste refactors voorkomen
+- contractbreuk voorkomen
+- stabiliteit bewaken
+
+---
+
+# Algemene regel
+
+AI-agents mogen alleen kleine, lokale, testbare wijzigingen uitvoeren.
+
+AI-agents mogen geen brede of structurele wijzigingen uitvoeren zonder expliciete toestemming van de gebruiker.
+
+---
+
+# Wijzigingen die ZONDER expliciete toestemming mogen
+
+De volgende wijzigingen mogen zelfstandig worden gedaan, mits regressietests slagen:
+
+- kleine bugfixes
+- toevoegen van nieuwe, lokale helperfuncties
+- toevoegen van logging zonder secrets
+- uitbreiden van bestaande responses met extra velden, zolang bestaande velden intact blijven
+- toevoegen van nieuwe endpoints, zolang bestaande endpoints niet wijzigen
+- uitbreiden van tests
+- verbeteren van foutafhandeling
+- verbeteren van type hints
+- kleine frontend-aanpassingen zonder wijziging van workflow
+- documentatie bijwerken
+
+---
+
+# Wijzigingen die ALLEEN met expliciete toestemming mogen
+
+De volgende wijzigingen zijn verboden zonder expliciete toestemming:
+
+- wijzigen van bestaande endpointnamen
+- wijzigen van bestaande response-structuren
+- verwijderen van velden uit API responses
+- wijzigen van token lifecycle logica
+- wijzigen van rename template
+- wijzigen van mount paths of allowed media roots
+- wijzigen van container runtime model
+- wijzigen van projectstructuur
+- wijzigen van SAFE FILES
+- vervangen van libraries of frameworkkeuzes
+- brede refactors over meerdere modules
+- wijzigen van securityregels rond file access
+
+---
+
+# Verboden wijzigingen
+
+De volgende wijzigingen zijn altijd verboden zonder expliciete opdracht:
+
+- code buiten deze repository aanpassen
+- andere containers aanpassen
+- system config wijzigen
+- firewall wijzigen
+- systemd global wijzigen
+- prune, cleanup of delete acties uitvoeren buiten deze projectscope
+- secrets hardcoden
+- API keys of tokens loggen
+
+---
+
+# Refactor Policy
+
+Geen silent refactors.
+
+Elke refactor moet:
+1. vooraf benoemd worden
+2. beperkt blijven in scope
+3. regressietests behouden
+4. geen API contract breken
+
+Als een wijziging niet strikt nodig is voor het gevraagde doel, moet de agent die wijziging niet doen.
+
+---
+
+# Test Policy
+
+Na iedere wijziging moeten minimaal drie regressietests worden uitgevoerd:
+
+- curl 127.0.0.1:8085/api/health
+- curl 127.0.0.1:8085/api/tvdb/auth-status
+- curl "127.0.0.1:8085/api/tvdb/search?q=elsbeth"
+
+Daarnaast moeten minimaal drie tests worden uitgevoerd voor de nieuwe of gewijzigde functionaliteit.
+
+Nieuwe feature tests moeten:
+- het gevraagde gedrag verifiëren
+- geen bestaande functionaliteit breken
+- waar mogelijk mechanisch herhaalbaar zijn
+
+---
+
+# Escalated Execution Policy
+
+Escalated execution is toegestaan binnen deze projectscope voor:
+
+- podman build
+- podman run
+- curl tests
+- bestanden aanmaken en aanpassen
+- dependency install binnen het project
+- lokale build- en testacties
+
+Escalated execution is niet toegestaan voor:
+
+- systeembrede wijzigingen
+- andere repositories
+- andere stacks of containers
+- destructieve cleanup acties
+
+---
+
+# Output Policy
+
+Bij elke wijziging moet de agent kort rapporteren:
+
+- welke bestanden zijn aangepast
+- waarom die wijziging nodig was
+- welke regressietests zijn uitgevoerd
+- welke feature tests zijn uitgevoerd
+- welke risico’s of aandachtspunten er nog zijn