Polycrate CLI 0.31.1¶

Release-Datum: 25. März 2026
Typ: Bugfix-Release

Highlights¶

Polycrate CLI 0.31.1 beinhaltet zwei Bugfixes, die das SDD-System aus 0.31.0 stabilisieren: Die Block-Artefakte-Secrets-Pfade werden jetzt korrekt aufgelöst, sodass die Workspace-Encryption greift. Außerdem enthalten CHANGELOG-Einträge automatisch das Author-Feld und Agent-Rules-Dateien werden beim spec init korrekt im Repo-Root generiert.

Artefakte¶

Docker Images¶

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

CLI Downloads¶

Installation & Update¶

polycrate update 0.31.1

→ Installationsanleitung

Bugfixes¶

Block Artifacts Secrets Path Korrektur¶

Problem: block.artifacts.secrets.path zeigte auf artifacts/blocks/<blockname>/secrets/ statt auf artifacts/secrets/<blockname>/. Da die Workspace-Encryption nur Dateien unterhalb von artifacts/secrets/ erfasst, wurden Block-Secrets nicht verschlüsselt.

Lösung:

• block.artifacts.secrets.*path wird jetzt korrekt nach artifacts/secrets/<blockname>/ aufgelöst
• WorkspaceConfig wurde um ein konfigurierbares secretsroot-Feld erweitert (Default: artifacts/secrets)
• Die Workspace-Encryption erkennt und verarbeitet Block-Secrets damit zuverlässig

# workspace.poly (optional — default ist artifacts/secrets)
config:
  secretsroot: artifacts/secrets

→ Ausführliche Dokumentation — Artefakte

CHANGELOG Author-Feld und SDD Agent-Rules-Generierung¶

Problem 1: CHANGELOG-Einträge enthielten kein author-Feld, obwohl dieses Teil des Formats ist und im SDD-System vorgesehen war.

Problem 2: polycrate spec rules generate schrieb AGENTS.md, CLAUDE.md und .cursor/rules/sdd.mdc in das interne .workspace/-Verzeichnis statt in den Repo-Root. Damit waren die Dateien für Git und AI-Agenten nicht sichtbar.

Problem 3: polycrate spec init rief rules generate nicht automatisch auf.

Lösung:

• polycrate release update setzt den Author automatisch aus der Git-Konfiguration (git config user.name + git config user.email), sofern kein expliziter --set author= gesetzt ist
• polycrate spec rules generate schreibt Agent-Rules-Dateien jetzt in den Repo-Root
• polycrate spec init ruft rules generate automatisch auf und legt AGENTS.md, CLAUDE.md und .cursor/rules/sdd.mdc direkt beim Setup an

# CHANGELOG-Eintrag mit automatischem Author
polycrate release update 1.0.0 --set type=feat --set message="Neue Features"
# author wird automatisch aus git config gesetzt

# Agent Rules (neu) im Repo-Root regenerieren
polycrate spec rules generate --force

Beispiel CHANGELOG-Eintrag:

- version: "1.0.0"
  date: "2026-03-25"
  type: feat
  author: "Fabian Peter <fabian@ayedo.de>"
  message: "Neue Features"

→ Ausführliche Dokumentation — Spec-Driven Development

Release Actions: Struct-Format für pre/post_actions¶

Problem: pre_actions und post_actions in workspace.poly wurden als []string implementiert (z.B. "docker push"), obwohl die 0.31.0 SDD-Spec ein typisiertes Struct-Format definiert. Das String-Splitting war brüchig und das optionale config-Feld fehlte.

Lösung: Typisiertes releaseAction-Struct mit block, action und optionalem config-Feld. polycrate release finalize führt nach dem Git-Tag automatisch die konfigurierten Post-Actions aus:

# workspace.poly
config:
  release:
    pre_actions:
      - block: app
        action: render
    post_actions:
      - block: golang
        action: build
      - block: docker
        action: push
      - block: app
        action: release

→ Ausführliche Dokumentation — Spec-Driven Development