feat(core): drop v2.0/v2.1 support, enforce minimum version v2.2.0

[flemzord]

Summary

• Add explicit version validation gate (ValidateMinimumVersion) in GetModuleVersion() rejecting stack versions < v2.2.0 with actionable error message
• Clean up all dead code branches for v2.0/v2.1 across webhooks, reconciliations, auths, brokers, and ledger
• Remove 7 orphaned functions: IsGreaterOrEqual, IsLower, hasAllVersionsGreaterThan, installLedgerSingleInstance, createLedgerContainerFull, createBaseLedgerContainer, createDeployment (ledger-local)

Net result: 12 files changed, 96 insertions, 208 deletions.

What's preserved

• Payments v2 branches — module version, not stack version
• Broker NATS stream detection — legacy streams may still exist on v2.2+ stacks
• Non-semver versions (dev tags, SHA refs) — pass through without validation

Test plan

• go build ./... passes
• go vet ./... passes
• New TestValidateMinimumVersion with 11 cases (v2.0.0, v2.1.0, v2.1.9, v2.0.0-rc.5, v2.2.0-alpha rejected; v2.2.0, v2.3.0, v3.0.0, non-semver, sha, latest accepted)
• Existing tests updated (v1.0.0 → v2.2.0 in stack/ledger controller tests)
• Integration tests compile
• No remaining IsGreaterOrEqual/IsLower references in codebase
• Reviewed by Codex (architecture) and Gemini (quality)

[coderabbitai]

No actionable comments were generated in the recent review. 🎉

ℹ️ Recent review info

⚙️ Run configuration

Configuration used: Organization UI

Review profile: CHILL

Plan: Pro

Run ID: ec0ad2c0-e89a-4e5d-b350-4fc54d4fcfe7

📥 Commits

Reviewing files that changed from the base of the PR and between fafb30a and a45739a.

📒 Files selected for processing (12)

• internal/core/version.go
• internal/core/version_test.go
• internal/resources/auths/configuration.go
• internal/resources/auths/deployment.go
• internal/resources/brokers/reconcile.go
• internal/resources/ledgers/deployments.go
• internal/resources/ledgers/init.go
• internal/resources/reconciliations/init.go
• internal/resources/webhooks/deployment.go
• internal/resources/webhooks/init.go
• internal/tests/ledger_controller_test.go
• internal/tests/stack_controller_test.go

💤 Files with no reviewable changes (2)

• internal/resources/webhooks/deployment.go
• internal/resources/ledgers/init.go

---

Walkthrough

The changes establish a new minimum supported stack version (v2.2.0) with validation, remove obsolete version gates for earlier releases, and simplify code paths that previously accommodated pre-v2.2.0 versions across authentication, broker, ledger, database migration, and webhook resources.

Changes

Cohort / File(s)	Summary
Version Management internal/core/version.go, internal/core/version_test.go	Introduces MinimumStackVersion constant and ValidateMinimumVersion function to enforce v2.2.0 floor; removes IsGreaterOrEqual and IsLower helpers; refactors GetModuleVersion to validate resolved versions.
Authentication Resources internal/resources/auths/configuration.go, internal/resources/auths/deployment.go	Removes v2.1.0 version gates; now unconditionally applies auth client secret handling regardless of stack version.
Broker Configuration internal/resources/brokers/reconcile.go	Removes semantic-version-based broker mode detection; unconditionally sets ModeOneStreamByStack after legacy-stream checks.
Ledger Resources internal/resources/ledgers/deployments.go, internal/resources/ledgers/init.go	Removes legacy single-instance ledger installation paths and v2.2.0-alpha version gates; eliminates associated container-assembly helpers; simplifies migration error handling.
Database & Webhook Migration internal/resources/reconciliations/init.go, internal/resources/webhooks/init.go, internal/resources/webhooks/deployment.go	Removes version gates from database migrations (v2.0.0-rc.5 and equivalents) and webhook deployment (v2.0.0-alpha to v2.0.0-rc.5 CLI argument gating).
Test Updates internal/tests/ledger_controller_test.go, internal/tests/stack_controller_test.go	Updates test versions from v1.0.0 / v0.0.0-test to v2.2.0 to align with new minimum stack version.

Estimated code review effort

🎯 3 (Moderate) | ⏱️ ~20 minutes

Poem

🐰 Version gates of old now fade away,
v2.2.0 marks a brighter day,
No more checks for lesser releases,
Our code grows lighter, logic increases,
Simpler paths for modern stacks,
Rabbits hop without looking back! 🐇✨

🚥 Pre-merge checks | ✅ 2 | ❌ 1

❌ Failed checks (1 warning)

Check name	Status	Explanation	Resolution
Docstring Coverage	⚠️ Warning	Docstring coverage is 23.08% which is insufficient. The required threshold is 80.00%.	Write docstrings for the functions missing them to satisfy the coverage threshold.

✅ Passed checks (2 passed)

Check name	Status	Explanation
Title check	✅ Passed	The title clearly and concisely summarizes the main change: dropping support for v2.0/v2.1 and enforcing v2.2.0 as the minimum version, which is the core objective of the PR.
Description check	✅ Passed	The description is comprehensive and directly related to the changeset, explaining the validation gate addition, dead code removal, preserved functionality, and test coverage.

_{✏️ Tip: You can configure your own custom pre-merge checks in the settings.}

✨ Finishing Touches

📝 Generate docstrings

• Create stacked PR
• Commit on current branch

🧪 Generate unit tests (beta)

• Create PR with unit tests
• Commit unit tests in branch feat/drop-v2.0-v2.1-support

---

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

• X
• Mastodon
• Reddit
• LinkedIn

_{Comment @coderabbitai help to get the list of available commands and usage tips.}