Documentation / Reference

CLI and installation version compatibility

Operate across 1.0.0 through 1.9.0 installations with automatic version detection and frozen wire contracts.

Version resolution and overrides

1. Explicit CLI flag: --installation-version <x.y.z> pins the contract before any network call.
2. Environment variable: RIPPFLOW_INSTALLATION_VERSION=<x.y.z> sets the version for CI jobs or shell sessions.
3. Automatic Controller discovery: queries GET /v1/installation and adapts wire headers (X-Rippflow-Installation-Version and X-Rippflow-Contract-Epoch).
4. Fail-closed diagnostics: commands requiring a newer release than the target installation supports fail closed with the minimum required version.
5. Offline docs independence: docs info, search_docs, vector_search_docs, get_doc, and get_docs read the bundled snapshot locally regardless of installation version.

Release range	Frozen epoch	Key capabilities
`1.0.0 ..= 1.0.4`	`v1.0.4-core-registry`	Core registry, workflow versions, activation, rollback, and stored-state execution lists.
`1.0.5 ..= 1.1.x`	`v1.0.6-durable-accounting`	Durable transition journal accounting and live activity execution views.
`1.2.0 ..= 1.6.x`	`v1.2.0` – `v1.4.0`	Multi-cell topology (`cells`, `distributions`) and workflow execution `controls`.
`1.7.0 ..= 1.8.1`	`v1.7.0` – `v1.8.1`	Governed `tools`, `mcp`, `operations`, Enterprise `rbac`, and signed `releases`.
`1.9.0 ..= 1.9.1`	`scoped-deployments-v1` / `native-iam-v1`	Scoped AWS IAM execution-plane deployments (`Default` grant table or `NativeIAM` self-service role paths `/tenants/<tenantId>/<role>`).
`1.10.0+`	`v1.10.0-edge-valkey-ingress`	`IngressMode=public-edge` (CloudFront + WAFv2 + S3 OAC + Function URL OAC) & `private-enterprise` (internal ALB), `__Host-rippflow_session` + `X-Rippflow-Csrf` (HMAC-keyed Valkey session validity `{"v":1,"active":true}` + TTL with zero PII/credentials/claims; DynamoDB authority on every request), and `rippflow auth machine-token` (`X-Rippflow-Machine-Token`).

shell

rippflow installation compatibility --installation-version 1.0.4 --json
rippflow commands --installation-version 1.8.1 --json

Verified sources

Checked 2026-11-05.