Repository navigation
Caatinga v2.0.0-alpha.0
Pre-release
Pre-release
Caatinga v2.0.0-alpha.0
Status
Alpha major release. Breaking changes on the Stellar CLI compatibility surface and removed override APIs.
Packages
@caatinga/cli@2.0.0@caatinga/core@2.0.0@caatinga/client@2.0.0
Install channel:
npm install -g @caatinga/cli@nextCompatibility
- Node.js 20+
- Stellar CLI minimum
23.0.0(hard failure below) - Stellar CLI last tested
25.2.0(advisory above; no override flag required) - Rust 1.84+ with
wasm32v1-nonetarget
Breaking changes
- Removed
STELLAR_CLI_TESTED_MAX_VERSION; use advisorySTELLAR_CLI_LAST_TESTED_VERSION. - Removed
assertSupportedStellarCliVersion; useevaluateStellarCliCompatibility. - Removed
CAATINGA_UNTESTED_CLI_VERSIONerror code. - Removed
--allow-untested-stellar-clifrombuild,deploy,generate,invoke, anddoctor. - Removed
allowUntestedStellarClifrom core command options.
Added
evaluateStellarCliCompatibility()returningCompatibilityReportwithwarnings[].checkStellarCliVersion()export from@caatinga/core.Diagnostic.warningsoncaatinga doctor(e.g.STELLAR_CLI_UNTESTED_VERSION).
Migration
Remove --allow-untested-stellar-cli if you used it locally — newer Stellar CLI versions now run with a non-fatal advisory. For CI gating on CLI version, rely on CAATINGA_UNSUPPORTED_CLI_VERSION (hard floor only).
Highlights
- Feature-aware Stellar CLI compatibility (hard floor + advisory last-tested)
- Template init no longer copies local
target/build artifacts - Architecture overview docs in
docs/architecture.md
Known limitations
- Alpha stability; APIs and artifact formats may still change before v1.
- No automated npm/GitHub release pipeline yet — publish remains operator-controlled.