Bisher musste ein Agent, der eine Anbindung aktualisiert, die gesamte Historie
lesen - oder er las gar nichts und uebersah eine brechende Aenderung. Beides
schlecht.
- public/docs/changelog.json ist die einzige Quelle. Je Fassung eine
Zusammenfassung, je Aenderung Bereich, ein "breaking"-Kennzeichen und vor
allem ein Feld "action" mit dem, was konkret zu tun ist. Steht dort null,
ist nichts zu tun - das ist die haeufigste und nuetzlichste Antwort.
- GET /api/updateservice/v1/changelog?since=2.2.0 liefert nur die neueren
Fassungen, dazu die Anzahl der Punkte mit Handlungsbedarf und der
brechenden Aenderungen. count:0 heisst "du bist auf Stand" - dann muss gar
nichts gelesen werden. Optional nach Bereich filterbar (?area=packager).
- /docs/changelog.php rendert dieselbe Datei fuer Menschen, mit Eingabefeld
fuer die eigene Fassung. Bewusst dieselbe Quelle: zwei Fassungen zu pflegen
hiesse, sie auseinanderlaufen zu lassen.
- DeploymentcenterSdk.Version im SDK ist der Bezugspunkt. Damit muss die
Fassung nicht abgetippt werden.
- AGENT_PROMPT_TEMPLATE.md verpflichtet dazu, sie in der AGENTS.md des
Projekts festzuhalten und vor jeder Aenderung an der Anbindung den
Unterschied abzufragen. Auch in der Kurzfassung fuer knappe Prompt-Budgets.
Die Historie ist rueckwirkend bis 2.0.0 gefuellt: 6 Fassungen, 25 Punkte mit
Handlungsbedarf, 13 brechende Aenderungen.
Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
