Changelog & Versionierung

Versionierungsrichtlinie

ObjectOS folgt Semantic Versioning: MAJOR.MINOR.PATCH.

Alle @objectstack/*-Pakete werden gemeinsam mit einer synchronisierten Versionsnummer veröffentlicht — sie werden als Matrix getestet, nicht einzeln.

Kompatibilitätsmatrix

Support-Zeiträume

Kritische Sicherheitsfixes werden auf den aktuellen und den vorherigen Major-Branch zurückportiert. Alles andere landet auf main.

Release Notes

Veröffentlichte ObjectOS-Versionen und ihre CHANGELOG-Einträge werden hier publiziert:

• npm: @objectstack/runtime
• GitHub: github.com/objectstack-ai/objectos/releases
• Quell-CHANGELOG: CHANGELOG.md
• Ausführliche Release Notes: RELEASE_NOTES.md

Abonnieren Sie Releases auf GitHub, um benachrichtigt zu werden.

Aktuelle Highlights

10.x — aktueller Release-Zug

ObjectOS One und der gebündelte Server laufen jetzt auf @objectstack 10.2.0. Trotz des Major-Sprungs ist der Runtime-Boot-Vertrag unverändert — createStandaloneStack nimmt weiterhin dieselben Artefakt-, Umgebungs- und Datenbankeinstellungen entgegen — und jeder Breaking Change landet in der Multi-Org-Mandantenschicht, sodass ein single-tenant ObjectOS-Deployment (der Standard) ohne Konfigurationsänderungen von 9.x weiterrollt. Was sich bewegt hat:

• Zeilenbezogenes Org-Scoping in ein eigenes Plugin ausgelagert (10.0, Breaking) — das automatische Stempeln von organization_id, das Pro-Org-Seed-Replay und der Default-Org-Bootstrap wurden aus @objectstack/plugin-security in das optionale @objectstack/plugin-org-scoping verschoben. Single-Org-Deployments sind schlanker (kein Wildcard-RLS, das bei jeder Abfrage entfernt werden muss), und OS_MULTI_TENANT=true registriert das Plugin weiterhin automatisch vor plugin-security, sodass per CLI gesteuerte Projekte keine Codeänderungen benötigen. Laut ADR-0002 ist ein Tenant physische Isolation (eine Umgebung = eine Datenbank); organization_id ist logisches Scoping innerhalb einer DB und verdient daher sein eigenes Plugin.
• Keine automatischen persönlichen Workspaces mehr (10.0, Breaking) — plugin-security erstellt nicht mehr für jeden neuen Benutzer eine „<User>'s Workspace"-Org. Benutzer nehmen jetzt eine Einladung an oder erstellen explizit ihre erste Organisation (das Slack-/Linear-/GitHub-Orgs-Modell). Der erste registrierte Benutzer — automatisch zum Plattform-Admin befördert — erhält im Multi-Tenant-Modus weiterhin eine einzige Default Organization, damit seine Session RLS auflöst; single-tenant Deployments erstellen keine Orgs.
• record-Formularfeldtyp (ADR-0014) — Record<string, X>-Eigenschaften (etwa die fields-Map eines Objekts) sind jetzt als vollwertige Formularfelder in Studio editierbar, statt als rohes JSON durchzusickern, und der Objektvorschau-Bereich bindet den echten ObjectGrid-Renderer ein — was Sie in der Vorschau sehen, ist das, was ausgeliefert wird.
• Steckbare Embeddings über IEmbedder — ein neues Embedder-Protokoll plus @objectstack/embedder-openai; die Knowledge-/RAG-Adapter nutzen jetzt IEmbedder und wurden umbenannt, um das plugin--Präfix abzulegen.
• Public Forms — anonyme Web-to-Lead-/Web-to-Case-Formulare, bereitgestellt unter /f/:slug, eine einheitliche FormPage (öffentlich /f/:slug + intern /forms/:name), eine type: 'form'-Aktionsvariante und defaultDetailForm auf ObjectSchema.
• Cloud-Identitätstrennung — os cloud login ist jetzt von os login getrennt, die Cloud-Control-Plane wurde in ein privates Repo verschoben (eine schlankere OSS-Runtime), und objectstack init scaffoldet wieder ein Projekt, das baut und bootet.

9.x

Der 9.x-Zug lief auf @objectstack 9.0 – 9.11 vor dem 10.0-Umstieg. Der Runtime-Boot-Vertrag ist gegenüber 8.0 unverändert — createStandaloneStack nimmt weiterhin dieselben Artefakt-, Umgebungs- und Datenbankeinstellungen entgegen —, sodass ein 8.0-Deployment ohne Konfigurationsänderungen weiterrollt. Was sich bewegt hat, ist die autorenseitige Oberfläche:

• Analytics-Datasets sind die einzige Autorenoberfläche (9.0, Breaking) — Dashboard-Widgets, Berichte und Listen-Charts binden jetzt ein semantisches dataset (defineDataset(...)) und wählen Dimensionen/Maße per Name. Die alten Inline-Abfragefelder (object/valueField/aggregate an Widgets, objectName/columns/groupingsDown an Berichten, xAxisField/yAxisFields an Listen-Charts) wurden entfernt. Migration: Verschieben Sie die Inline-Abfrage in ein defineDataset und referenzieren Sie es per Name. ChartTypeSchema hat außerdem 8 Varianttypen verworfen, die nur als ihr Basistyp gerendert wurden (stacked-bar→bar, spline→line, bubble→scatter, …).
• Strengere Validierung zur Build-Zeit (9.6–9.7) — os compile scheitert jetzt an blanken Feldreferenzen (amount statt record.amount), unbekannten CEL-Funktionen und falscher Interpolationssyntax für Flow-Werte, jeweils mit einem „Meinten Sie"-Hinweis. Ein Stack, der zuvor „baute, aber stillschweigend falsch war", scheitert jetzt lautstark — führen Sie os compile nach dem Upgrade erneut aus und beheben Sie, was es bemängelt.
• Zahlenfeld-Formeln berechnen gemischte Arithmetik (9.7) — record.amount / 100 und record.price * 2 werten jetzt aus, statt stillschweigend null zu liefern; der / 100.0-Float-Literal-Workaround ist nicht mehr nötig.
• REST-Gating auf Objektebene, jetzt durchgesetzt (ADR-0049) — apiEnabled: false eines Objekts entfernt es aus der REST-Oberfläche, und eine apiMethods-Whitelist schränkt ein, welche Operationen erreichbar sind. Zuvor geparst, aber nicht durchgesetzt.
• Paketdokumentation als Metadaten + book-Navigation (9.3–9.6) — src/docs/*.md registrieren sich als doc-Metadaten; das book-Element (ADR-0046) deklariert eine Navigationsachse mit abgeleiteter Mitgliedschaft, bereitgestellt unter GET /api/v1/meta/book/:name/tree mit Audience-Gating.
• os package install (9.3) — installiert ein Paket in eine laufende Runtime aus einer Katalog-ID oder einem Inline-Artefakt für Air-Gap-Umgebungen, authentifiziert mit --email / --password.
• Genehmigungen (9.3) — Zurücksenden zur Überarbeitung (maxRevisions, Standard 3), jobs-gestützte SLA-Auto-Eskalation, Listensuche/Paginierung und sitzungsfreie zweisprachige Bestätigungslinks zum Genehmigen/Ablehnen.
• Eingehende Webhook-Flow-Trigger (9.3) — ein type: 'api'-Flow stellt einen HMAC-verifizierten POST /api/v1/automation/hooks/:flowName/:hookId-Endpunkt mit idempotenter, queue-gestützter Aufnahme bereit.
• Aufbewahrung von Benachrichtigungen standardmäßig aktiv (9.5) — der Benachrichtigungsverlauf wird automatisch nach 90 Tagen bereinigt; setzen Sie die Messaging-Einstellung retentionDays: 0, um den Verlauf dauerhaft zu behalten.
• CLI bündelt AI-Provider-SDKs (9.0) — OpenAI-kompatible Provider (DeepSeek, DashScope, SiliconFlow, OpenRouter, Cloudflare) funktionieren auf einer global installierten CLI sofort.

Eine zu beachtende Verhaltensänderung beim Flow-Authoring: Der outputVariable eines create_record-Knotens hält jetzt das erstellte Datensatzobjekt (zuvor die blanke ID), aktualisieren Sie also {var}-Referenzen, die eine ID erwarteten, auf {var.id}.

8.0.x

ObjectOS One und der gebündelte Server liefen auf @objectstack 8.0.1.

• MCP über Streamable HTTP — jede Bereitstellung kann als netzwerkerreichbarer Model-Context-Protocol-Server fungieren. Aktivierung über OS_MCP_SERVER_ENABLED=true; der Endpunkt liegt unter /api/v1/mcp mit fail-closed-Authentifizierung (anonyme Anfragen werden abgelehnt). Das Plugin wurde von @objectstack/plugin-mcp-server zu @objectstack/mcp umbenannt.
• Self-Service-API-Keys — POST /api/v1/keys erzeugt einen nur einmal angezeigten sys_api_key. Die REST-Daten- und Metadaten-APIs (/api/v1/data, /api/v1/meta) authentifizieren API-Keys jetzt über denselben Verifier wie MCP und laufen mit den Berechtigungen und der Datensatz-Sicherheit des Key-Inhabers.
• Feldbezogene Bedingungsregeln — visibleWhen, readonlyWhen und requiredWhen werden serverseitig von ObjectQL durchgesetzt, nicht nur in der Formular-UI.
• Wiederverwendbarer RLS-Lesefilter — security.getReadFilter(object, context) stellt den Datensatzzugriffs-Lesebereich bereit; Analytics-Datasets, Dashboards und Berichte greifen darauf zu und schließen fail-closed, wenn der Bereich nicht sicher angewendet werden kann.
• Standalone-Host-Stack — die Runtime liefert einen single-tenant createStandaloneStack-Host; der cloud-verbundene, hostname-geroutete createObjectOSStack-Wrapper aus 7.x wurde entfernt. Eine Cloud-Bereitstellung verweist OS_ARTIFACT_FILE jetzt auf eine veröffentlichte Artifact-URL.

5.0 — Umbenennung project → environment (veröffentlicht)

Das Runtime-Konzept, das früher Project hieß, wurde durchgängig in Environment umbenannt. Betroffen waren:

• CLI-Flags: --environment / -e
• HTTP-Pfade: /api/v1/environments/:environmentId/...
• Header: X-Environment-Id
• Umgebungsvariablen: OS_ENVIRONMENT_ID (OS_PROJECT_ID bleibt als veralteter Alias erhalten)
• DB-Spalten: environment_id
• JSON-Schemas: EnvironmentArtifact

Upgrade

Siehe Upgrade und Rollback für die konkreten Schritte. Vorab-Prüfung:

1. Lesen Sie den CHANGELOG-Eintrag für jede Minor-Version zwischen Ihrer aktuellen und der Zielversion.
2. Führen Sie os diff <old-artifact> <new-artifact> aus, um Breaking Schema-Änderungen aufzudecken.
3. Führen Sie os doctor gegen die Zielversion aus.
4. Bringen Sie eine Canary-Instanz hoch, bevor Sie die gesamte Flotte ausrollen.
5. Halten Sie einen Rollback-Plan sowohl für das Image-Tag als auch für die Artefakt-Version bereit (sie werden unabhängig voneinander ausgerollt).

Regressionen melden

Wenn ein Patch oder eine Minor-Version etwas zuvor Funktionierendes bricht, melden Sie einen Bug unter github.com/objectstack-ai/objectos/issues mit der Version, von der / auf die Sie aktualisiert haben. Wir behandeln Regressionen als die höchstpriorisierte Fehlerklasse.