Skip to main content

Compatibility and limits

This is the currently asserted compatibility surface. Absence from the table means no support range has been established, not that the combination is known to work.

AreaCurrent contract
Pipeline examples and resource librariesGo 1.26.5 modules
Pipeline SDK and agent modulesdeclare Go 1.25.7; current examples require newer Go
ServerGo 1.26.5 module
Server-side materializationbuilt-in Go runtime reports 1.26
Self-built worker imageLinux/amd64 only
Machine agentLinux; runc default, exec development runtime
Agent servicegenerated installer supports systemd; other init systems require manual service wiring
Development control planeDocker with Compose and access to the Docker socket
Studio developmentNode.js 22.23.1; web renderer plus Electron packaging commands
Kubernetes librarynative Go API types; no published Kubernetes/provider version range

There is no versioned compatibility promise yet between independently released server, agent, pipeline SDK, Studio and generated Management API bindings. Keep their revisions together when testing a deployment and regenerate Studio bindings from the target server contract.

Known functional limits

  • dev is not implemented; local planning works, execution needs a server.
  • Production deployment, HA, backup/restore and upgrade procedures are not shipped.
  • Git source trees are read-only.
  • A manual start under Queue is refused while another run is active; the pending slot belongs to automatic triggers.
  • List watch in graphenectl polls; observation streams and run watch are push.
  • Permanently lost agent machines cannot yet be buried through supported CLI.
  • External KMS/Vault secret lifecycle is not available.

Check Current state before evaluating a design and Security before connecting real infrastructure.