Polycrate CLI 0.34.0¶

Release-Datum: 12. April 2026
Typ: Feature-Release

Highlights¶

Polycrate CLI 0.34.0 bringt die SDD Phase 2–4 mit einem grundlegend überarbeiteten Spec-Lifecycle, einem umfangreichen Operator Cleanup (ArtifactDiscovery und Embedded CRDs vollständig entfernt) sowie dem automatischen Block Template-Flag für installedBlocks. Die SDD-Erweiterungen umfassen einen neuen 5-Status-Lifecycle, Risikofelder, eine vereinfachte Section-Struktur (## Context statt Family A/B/C) und strukturierte Release Notes via RELEASENOTE.md.

Artefakte¶

Docker Images¶

docker pull cargo.ayedo.cloud/library/polycrate:0.34.0

CLI Downloads¶

Installation & Update¶

polycrate update 0.34.0

→ Installationsanleitung

Neue Features¶

SDD 5-Status-Lifecycle¶

Der Spec-Lifecycle wurde von 4 auf 5 Status erweitert und die Übergänge formalisiert:

planned → pending-approval → approved → pending-verification → implemented
any     → cancelled

spec finalize heißt jetzt spec submit und wechselt in den Status pending-approval. Die alten Status-Aliase (in-progress → planned, ready → approved) werden weiterhin akzeptiert.

→ SDD Status-Lifecycle — Dokumentation

SDD Section-Schema: ## Context statt Family A/B/C¶

Die bisherigen typabhängigen Sektionen (## Problem, ## Analysis, ## Root Cause, ## Feature Description) werden durch eine einheitliche ## Context-Sektion ersetzt. Alle Spec-Typen verwenden dasselbe Sektionsschema — die typspezifischen Sektionsnamen bleiben als Aliase erhalten.

→ Sektionsschema — Dokumentation

SDD Risikofelder: severity, likelihood, impact¶

Specs können jetzt mit Risikofeldern annotiert werden:

polycrate spec update <id> --set severity=high --set likelihood=medium --set impact=high
polycrate spec list --min-severity medium

Erlaubte Werte: low, medium, high.

→ Risikofelder — Dokumentation

SDD relates-to Links¶

Neben blockierenden needs-Abhängigkeiten gibt es jetzt thematische (nicht-blockierende) relates-to-Verknüpfungen:

polycrate spec update <id> --add-relates-to 42
polycrate spec link <id> --relates-to 42

→ Abhängigkeiten & Labels — Dokumentation

SDD review-Sektion¶

Neue Sektion ## Review für Post-Implementierungs-Feedback:

polycrate spec update <id> --section review="Reviewed: Lösung passt, keine Nacharbeit nötig."

RELEASENOTE.md — Strukturierte Release Notes¶

polycrate release note create erzeugt eine strukturierte RELEASENOTE.md im Release-Verzeichnis mit Frontmatter und den Sektionen highlights (Pflicht), changes, fixes, migration:

polycrate release note create 0.34.0
polycrate release note inspect 0.34.0 --no-pager
polycrate release note status 0.34.0

release finalize prüft, dass die highlights-Sektion nicht leer ist.

→ RELEASENOTE.md — Dokumentation

Block app_version via CLI¶

Block-Versionen können jetzt direkt über die CLI gesetzt werden, statt manueller Datei-Bearbeitung:

polycrate release finalize 0.34.0 --block cargo.ayedo.cloud/ayedo/k8s/polycrate-operator

Release pre_actions: CRD-Export und API-Client-Codegen¶

release finalize führt automatisch app generate-crds und app generate-api-client als pre_actions aus. Die Konfiguration erfolgt in workspace.poly:

config:
  release:
    pre_actions:
      - block: app
        action: generate-crds
        local: true
      - block: app
        action: generate-api-client
        local: true

Block Template-Flag¶

Installierte Blocks (aus der Registry) erhalten automatisch template: true. Dies ermöglicht die korrekte Unterscheidung zwischen Template-Blocks und Instanz-Blocks im Workspace.

SDD Spec-Authoring Zweitschritt¶

Spec-Authoring hat jetzt einen formalen Pflichtreview-Schritt: Nach dem Drafting muss ein Spec über spec submit eingereicht und reviewed werden, bevor er als approved gilt.

SDD Compliance Alignment¶

Normen-Mapping (ISO 27001, DSGVO, DORA) und Prozessoptimierung für das SDD-Framework.

Fixes¶

• release finalize Guard: Schlägt nicht mehr fehl wenn release create die Spec bereits ins versionierte Verzeichnis verschoben hat (112)
• spec finalize Validator: Prüft solution jetzt korrekt für Family B Specs — feature-description als primäre Sektion (116)
• K8sApp Operator Reconciler: Block FK wird nicht mehr auf null gesetzt wenn die Resolution fehlschlägt (117)
• Leerer Workspace: Dependency Resolution schlägt bei leerem Workspace nicht mehr fehl (118)
• spec inspect: Vollständige Section-Ausgabe im Coding-Agent-Kontext — keine stille Trunkierung mehr (119)
• Artifact Archive Mode: PATCH-Requests im Operator entfernt (115)
• SetSection Validation: H1/H2-Headings in Section-Content werden beim Schreiben und Lesen validiert (133)

Refactoring & Cleanup¶

• ArtifactDiscovery vollständig entfernt: Der gesamte Artifact-Discovery- und Artifact-Sync-Code wurde aus CLI und Operator entfernt. Die Artifact CRD wird beim Operator-Update automatisch gelöscht (132)
• Embedded CRD Infrastruktur entfernt: CRDs werden ausschließlich über den polycrate-operator Block verwaltet — die deprecated operator install-crds / operator update-crds Commands wurden entfernt (134)

polycrate-operator Block¶

Der polycrate-operator Block wurde auf Version 0.3.49 aktualisiert (app_version: 0.34.0):

polycrate pull cargo.ayedo.cloud/ayedo/k8s/polycrate-operator
polycrate run polycrate-operator install

Wichtig: Beim Update wird die Artifact CRD automatisch gelöscht (cascading delete). Bestehende Artifact Custom Resources werden entfernt.

Migration¶

SDD Section-Schema (Breaking)¶

Die typabhängigen Sektionsnamen wurden durch ## Context ersetzt. Bestehende Specs behalten ihre bisherigen Sektionen — sie werden als Aliase erkannt. Neue Specs verwenden automatisch ## Context.

Artifact CRD Entfernung¶

Die Artifact CRD (polycrate.io/v1alpha1 Artifact) wird beim Operator-Update automatisch gelöscht. Falls Workflows auf Artifact Custom Resources basieren, müssen diese vorher migriert werden.

Jetzt aktualisieren¶

polycrate update 0.34.0

Oder laden Sie die Binaries direkt vom PolyHub herunter.