Compatibility

This compatibility page is generated from canonical repo-owned source material in JaddaHelpifyr/jhf-deployment.

Compatibility Sources

• docs/OSS_INVENTORY.md
• docs/PUBLIC_SURFACES.md

Derived from OSS Inventory (Fabric Consumer Mode)

OSS Inventory (Fabric Consumer Mode)

jhf-deployment consumes OSS upgrade/version truth from Fabric as canonical source of truth and does not define a competing platform-wide OSS upgrade authority.

Canonical Fabric contracts consumed by this repo:

• contracts/platform/platform_version_truth.json
• contracts/platform/platform_projection_catalog.json
• contracts/platform/platform_oss_upgrade_governance_v1.json
• contracts/platform/platform_oss_upgrade_compatibility_matrix_v1.json
• contracts/platform/platform_oss_upgrade_evidence_contract_v1.json
• contracts/platform/helpifyr_stack_module_identity_v1.json
• contracts/platform/stack_tool_oss_inventory_directory.json
• docs/contracts/HELPIFYR_PLATFORM_OSS_UPGRADE_GOVERNANCE.md
• docs/contracts/HELPIFYR_STACK_MODULE_IDENTITY.md
• docs/contracts/HELPIFYR_STACK_TOOL_OSS_INVENTORY_DIRECTORY.md

Repo-local consumer bindings:

• maintenance/fabric-oss-upgrade-consumption.json
• maintenance/platform-oss-upgrade-rollout-governance.json
• maintenance/oss-version-truth.json
• maintenance/coordinated-upgrade-catalog.json
• maintenance/stack-upgrade-owner-boundaries.json
• maintenance/openclaw-2026.5.20-<internal-runtime-redacted>
• maintenance/openclaw-2026.5.20-bounded-verify-lane.json
• maintenance/openclaw-2026.5.22-<internal-runtime-redacted>
• maintenance/openclaw-2026.5.22-bounded-verify-lane.json
• maintenance/openclaw-2026.6.8-<internal-runtime-redacted>
• maintenance/openclaw-2026.6.8-bounded-verify-lane.json
• maintenance/spindle-erpnext-v16-<internal-runtime-redacted>

Candidate Evaluation: OpenClaw 2026.5.20

Current deployment truth remains pinned to OpenClaw 2026.5.12 in the default environments/test version path and the checked example pins. <internal-runtime-redacted> also currently runs ghcr.io/openclaw/openclaw:2026.5.12 on openclaw-gateway.

The deployment-owned evaluation artifact maintenance/openclaw-2026.5.20-<internal-runtime-redacted> records:

• current <internal-runtime-redacted> runtime truth (2026.5.12, healthy)
• current repo pin truth (2026.5.12)
• the official upstream release delta review for 2026.5.18, 2026.5.19, and 2026.5.20
• the non-mutating gate verdict from:
  • Fabric stack contract compliance inventory
  • stack OSS runtime materialization verification
  • bounded Stage-2 candidate certification evidence

Current recommendation:

• 2026.5.20 is a plausible bounded deployment candidate
• <internal-runtime-redacted> rollout stays deferred in this slice
• next step is a bounded staging or branch verify path before any <internal-runtime-redacted> main rollout pin changes are made

Bounded Verify Lane: OpenClaw 2026.5.20

The deployment-owned bounded verify contract maintenance/openclaw-2026.5.20-bounded-verify-lane.json materializes the next step after the readiness evaluation:

• candidate image version proof is read directly from the OpenClaw image on <internal-runtime-redacted> via /app/package.json
• Stage-2 certification must consume that real candidate-version proof
• <internal-runtime-redacted> remains read-only and must stay on 2026.5.12
• the bounded lane reruns:
  • Fabric stack contract compliance inventory
  • strict <internal-runtime-redacted> stack OSS runtime materialization
  • deployment-owned jhf-beam live SSH attachment gate

Candidate Re-Evaluation: OpenClaw 2026.5.22

OpenClaw 2026.5.22 is now the latest stable candidate and supersedes 2026.5.20 as the active rollout target. <internal-runtime-redacted> still remains pinned to 2026.5.12 in this slice.

The deployment-owned artifact maintenance/openclaw-2026.5.22-<internal-runtime-redacted> records:

• current <internal-runtime-redacted> runtime truth (2026.5.12, healthy)
• current repo pin truth (2026.5.12)
• the upstream delta review for 2026.5.20, 2026.5.22, and 2026.5.24-beta.1
• the non-mutating gate verdict from:
  • Fabric stack contract compliance inventory
  • stack OSS runtime materialization verification
  • bounded Stage-2 candidate certification evidence
  • bounded practical verify lane

Current recommendation:

• 2026.5.22 is the current latest stable candidate
• the bounded practical verify lane is green
• the next step is now a dedicated controlled <internal-runtime-redacted> rollout slice with snapshot, rollback, pin update, and post-rollout live verify

Controlled <internal-runtime-redacted> Rollout: OpenClaw 2026.5.22

The deployment-owned artifact maintenance/openclaw-2026.5.22-<internal-runtime-redacted> captures the actual <internal-runtime-redacted> live rollout that followed the bounded candidate lane:

• pre-change snapshot under <internal-home-redacted>/
• runtime-owner rollout branch/worktree and compose path
• rollback trigger plus last-known-good 2026.5.12 compose command
• post-change <internal-runtime-redacted> runtime readback (2026.5.22, running, healthy)
• owner-side live verifies from jhf-openclaw-env
• deployment-owned end-to-end rerun against the now-upgraded <internal-runtime-redacted>

Bounded Verify Lane: OpenClaw 2026.5.22

The deployment-owned bounded verify contract maintenance/openclaw-2026.5.22-bounded-verify-lane.json keeps the same non-mutating lane shape:

• candidate image version proof is read directly from the OpenClaw image on <internal-runtime-redacted> via /app/package.json
• Stage-2 certification must consume that real candidate-version proof
• <internal-runtime-redacted> remains read-only and must stay on 2026.5.12
• the bounded lane reruns:
  • Fabric stack contract compliance inventory
  • strict <internal-runtime-redacted> stack OSS runtime materialization
  • deployment-owned jhf-beam live SSH attachment gate

Candidate Re-Evaluation: OpenClaw 2026.6.8

OpenClaw 2026.6.8 is now the current latest stable candidate and supersedes the earlier 2026.5.22 rollout target for the next bounded upgrade slice. <internal-runtime-redacted> remains pinned live to 2026.5.22 in this re-evaluation slice.

The deployment-owned artifact maintenance/openclaw-2026.6.8-<internal-runtime-redacted> records:

• current <internal-runtime-redacted> runtime truth (2026.5.22, healthy)
• current repo-default pin truth (2026.5.22) for the reusable Stage-2 test lane after the completed 2026.5.22 <internal-runtime-redacted> rollout
• the upstream release delta review for 2026.6.8, 2026.6.8-beta.2, and 2026.6.8-beta.1
• the non-mutating gate verdict from:
  • Fabric stack contract compliance inventory
  • stack OSS runtime materialization verification
  • bounded Stage-2 candidate certification evidence
  • bounded practical verify lane

Current recommendation:

• 2026.6.8 is the current latest stable candidate
• the bounded practical verify lane is green without changing <internal-runtime-redacted>
• the next step is a dedicated controlled <internal-runtime-redacted> rollout slice with snapshot, rollback, pin update, and post-rollout live verify

Planned <internal-runtime-redacted> Rollout Lane: Spindle ERPNext/Frappe 15 -> 16

The deployment-owned contract maintenance/spindle-erpnext-v16-<internal-runtime-redacted> defines the bounded <internal-runtime-redacted> live rollout lane for the Spindle ERPNext/Frappe major upgrade without executing the cutover in this slice.

The lane is intentionally fail-closed:

• <internal-runtime-redacted> rollout remains blocked until <internal-runtime-redacted> certification (jhf-deployment#406) and Beam certification (jhf-beam#240 / #241) are green.
• rollout requires parity readback between <internal-runtime-redacted> and <internal-runtime-redacted> for commit, version vector, runtime identity, and critical parameters.
• freeze, scheduler/worker drain, fresh financial baseline capture, pre-change snapshot, rollback triggers, and post-live verify are declared before any live mutation is allowed.
• post-live unfreeze is blocked until auth, MCP/business smokes, financial reconciliation, payment sanity when present, PDF/print sanity, and the first five-minute monitoring window are green.

Verification

• fail-closed local truth alignment:
  • python3 scripts/validate-oss-version-truth.py
• fail-closed Fabric consumer contract verification (fixture mode for CI):
  • python3 scripts/verify-fabric-oss-upgrade-consumption.py --fixtures-dir tests/fixtures/fabric-platform-oss --output test-results/fabric-oss-upgrade-consumption.ci.json
• fail-closed deployment rollout governance verification (fixture mode + dry-run evidence):
  • python3 scripts/verify-platform-oss-upgrade-rollout-governance.py --fixtures-dir tests/fixtures/fabric-platform-oss --evidence tests/fixtures/platform-oss-upgrade-rollout/valid-rollout-evidence.json --output test-results/platform-oss-upgrade-rollout-governance.ci.json
• fail-closed Fabric consumer readback (live mode):
  • python3 scripts/verify-fabric-oss-upgrade-consumption.py --output test-results/fabric-oss-upgrade-consumption.live.json
• fail-closed deployment rollout governance readback (live mode):
  • python3 scripts/verify-platform-oss-upgrade-rollout-governance.py --evidence tests/fixtures/platform-oss-upgrade-rollout/valid-rollout-evidence.json --output test-results/platform-oss-upgrade-rollout-governance.live.json
• bounded candidate evaluation:
  • python3 scripts/run-stage2-openclaw-certification.py --target-version 2026.5.20 --json-command 'python -c "import json; print(json.dumps({\"ok\": True, \"target_version\": \"2026.5.20\"}))"' --output test-results/stage2-openclaw-certification.2026.5.20.eval.json --stack-contract-compliance-evidence-output test-results/fabric-stack-contract-compliance-inventory.stage2-2026.5.20.eval.json --json-clean-evidence-output test-results/stage2-openclaw-json-clean-evidence.2026.5.20.eval.json --promotion-payload-output test-results/stage2-openclaw-promotion-payload.2026.5.20.eval.json
• bounded practical verify lane:
  • python3 scripts/run-stage2-openclaw-2026-5-20-bounded-verify.py --output test-results/openclaw-2026.5.20-bounded-verify.local.json
• latest stable bounded practical verify lane:
  • python3 scripts/run-stage2-openclaw-2026-5-20-bounded-verify.py --target-version 2026.6.8 --candidate-image ghcr.io/openclaw/openclaw:2026.6.8 --source-issue 744 --expected-<internal-runtime-redacted> ghcr.io/openclaw/openclaw:2026.5.22 --output test-results/openclaw-2026.6.8-bounded-verify.local.json
• controlled <internal-runtime-redacted> rollout rerun:
  • python3 scripts/run-stage2-openclaw-2026-5-20-bounded-verify.py --target-version 2026.5.22 --candidate-image ghcr.io/openclaw/openclaw:2026.5.22 --source-issue 385 --expected-<internal-runtime-redacted> ghcr.io/openclaw/openclaw:2026.5.22 --output test-results/openclaw-2026.5.22-<internal-runtime-redacted>
• Spindle ERPNext/Frappe <internal-runtime-redacted> rollout lane contract:
  • python3 maintenance/verify-maintenance-contracts.py
• live <internal-runtime-redacted> non-mutating version/materialization readback:
  • python3 scripts/verify_stack_oss_runtime_materialization.py --live-via-ssh <internal-runtime-redacted><internal-runtime-redacted> --fail-on-non-env-floating --output test-results/stack-oss-runtime-materialization.2026-05-22.eval.json
• maintenance contract lane:
  • python3 maintenance/verify-maintenance-contracts.py

Fail-closed posture

• missing/unreadable Fabric SoT contracts fail
• missing required Fabric docs contracts fail
• local shadow copies of Fabric platform OSS contracts fail
• local latest assumptions are forbidden in OSS version truth
• deployment rollout evidence fails closed on missing target_version, missing compatibility gate, missing postdeploy readback, missing rollback evidence, or latest-only posture

---

License: AGPLv3 Source and governance: https://helpifyr.com