Polycrate CLI 0.33.0¶

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

Highlights¶

Polycrate CLI 0.33.0 verbessert das SDD-Tooling erheblich: spec list und release list erhalten erweiterte Filter- und Ausgabeformat-Optionen für maschinenlesbare Pipelines und Agent-Workflows. Dazu kommen Volume Discovery für PersistentVolumes im Cluster, ein kompakter Ansible Output Callback sowie mehrere SDD-Bugfixes und Dokumentationsverbesserungen.

Artefakte¶

Docker Images¶

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

CLI Downloads¶

Installation & Update¶

polycrate update 0.33.0

→ Installationsanleitung

Neue Features¶

spec list — erweiterte Filter und Ausgabeformate¶

spec list unterstützt jetzt einen vollständigen Satz an Filter- und Format-Optionen für den Einsatz in Pipelines und Agent-Workflows. Wenn --format gesetzt ist, wird die TUI übersprungen und die Ausgabe geht direkt auf stdout.

# Nur offene Specs (nicht implemented, nicht cancelled)
polycrate spec list --open

# Sortieren — Standard: id, optional :desc
polycrate spec list --sort created:desc
polycrate spec list --sort name

# Strukturierte Ausgabe — überspringt TUI
polycrate spec list --format table
polycrate spec list --format tsv
polycrate spec list --format csv
polycrate spec list --format json

# Spalten konfigurieren (für table/tsv/csv)
polycrate spec list --format tsv --columns id,status,name
polycrate spec list --format table --no-header

# Kombinierbar mit bestehenden Filtern
polycrate spec list --open --sort created:desc --format tsv --columns id,status,name,type

Verfügbare Spalten: id, status, name, type, created, labels, needs, blocked, version

→ spec list — Dokumentation

release list — Sortierung und Ausgabeformate¶

Analog zu spec list erhält auch release list vollständige Sort- und Format-Optionen:

# Sortieren
polycrate release list --sort version:desc
polycrate release list --sort specs
polycrate release list --sort pending

# Strukturierte Ausgabe
polycrate release list --format table
polycrate release list --format tsv --columns version,type,message,specs
polycrate release list --format csv --no-header
polycrate release list --format json

Verfügbare Sortierfelder: version, specs, pending, released
Verfügbare Spalten: version, type, message, specs, pending, released, date

→ release list — Dokumentation

Volume Discovery¶

Der Operator erkennt nun PersistentVolumes im Cluster und synchronisiert sie als K8sVolume-Ressourcen in die API.

# Automatisch entdeckt:
apiVersion: polycrate.io/v1alpha1
kind: K8sVolume
metadata:
  name: pvc-abc123
spec:
  storageClass: local-path
  capacity: 10Gi
  accessModes: [ReadWriteOnce]

Volume Discovery ist automatisch aktiv — keine Konfigurationsänderung erforderlich.

Ansible Output Callback: Kompakter Terminal-Output¶

Polycrate verwendet jetzt ein eigenes Ansible Callback Plugin (ansible-polycrate), das den Terminal-Output erheblich kompakter macht. Lange Ansible-Ausgaben mit redundanten Task-Details werden auf das Wesentliche reduziert.

Das Plugin ist im Container enthalten und wird automatisch verwendet. Keine Konfigurationsänderung erforderlich.

SDD-Verbesserungen¶

Temporäre Spec-Section-Dateien unter /tmp/.polycrate/¶

Agent-Regeln wurden präzisiert: Temporäre Staging-Dateien für --section-file dürfen ausschließlich unter /tmp/.polycrate/spec-sections/ abgelegt werden — niemals unter .specs/. Dies verhindert versehentliche Direkt-Edits des Spec-Index.

mkdir -p /tmp/.polycrate/spec-sections
# Staging-Datei schreiben, dann:
polycrate spec update <id> --section-file solution=/tmp/.polycrate/spec-sections/spec-<id>-solution.md

ARCHITECTURE.md als explizite Ausnahme in Agent-Regeln¶

.specs/ARCHITECTURE.md ist jetzt explizit als direkt editierbare Ausnahme in allen Agent-Regel-Dateien (CLAUDE.md, AGENTS.md, .cursor/rules/sdd.mdc) dokumentiert. Alle anderen Dateien unter .specs/ bleiben verboten für Direkt-Edits.

Operator Discovery/Sync Architektur dokumentiert¶

Die Discovery→API-Pfade des Operators sind nun als Pattern A (Adopt Existing) und Pattern B (Standard Create/Update) dokumentiert — als Referenz für Block-Entwicklung und neue Discovery-Typen.

Fixes¶

• PreCommitSecurityCheck: RunPreCommitSecurityCheckInPath initialisiert SecretsRoot jetzt korrekt — kein leerer Pfad mehr bei polycrate workspace sync
• spec index rebuild: next_id wird beim Rebuild korrekt auf maxID + 1 zurückgesetzt
• spec manual: -w Pfad zeigt nun korrekt auf den Workspace-Root (nicht auf .specs/); spec list Standard-Sortierung nach ID
• Operator K8sApp Discovery: Parity mit Workspace-Reconciliation hergestellt

polycrate-operator Block¶

Der polycrate-operator Block wurde auf Version 0.3.46 aktualisiert (app_version: 0.33.0):

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

Jetzt aktualisieren¶

polycrate update 0.33.0

Oder laden Sie die Binaries direkt vom PolyHub herunter.