Runtime Fit Preflight Doctor v1.0

Category: automation

Price: $4.99

Release status: READY_FOR_LISTING / DOCS_COMPLETE

Source QA: Viper APPROVED_FOR_RELEASE and Warlock security-cleared on 2026-05-27

What it does

Runtime Fit Preflight Doctor helps OpenClaw operators decide whether a runtime or point-release upgrade is safe before they touch production. It reviews local workspace markers and release notes, flags upgrade-breaking signals, and returns a clear SAFE, WARN, or BLOCKED decision with restore-point and dummy-machine test guidance.

It is built for cautious upgrade planning: the tool only reads local files, does not run upgrade commands, and turns release uncertainty into a practical checklist.

Use cases

OpenClaw admins preparing upgrades who need a fast go/no-go check before applying a new gateway or runtime release.
Consultants managing client agent stacks who need evidence-backed rollback and dummy-machine test recommendations.
Teams with scheduled agents or cron-heavy setups who want to catch gateway, dependency, cron, and one-way migration risks before downtime.

Requirements

OpenClaw workspace with AGENTS.md, MEMORY.md, and skills/ markers for the strongest readiness signal.
Python 3 with standard library only; no pip dependencies.
Optional local release-notes file in Markdown/text format.
No API keys required.
Tested against the OpenClaw v2026.3.23 workspace pattern.

Example usage


python3 skills/runtime-fit-preflight-doctor/scripts/runtime_fit_preflight.py \
  --workspace /root/.openclaw/workspace \
  --release-notes ./release-notes.md \
  --json

Expected output


{
  "ok": false,
  "decision": "WARN",
  "risk_score": 40,
  "findings": [
    {"severity": "high", "code": "gateway_risk", "matches": 1},
    {"severity": "medium", "code": "dependency_risk", "matches": 1}
  ],
  "restore_point_checklist": [
    "Record current version and config checksum before upgrade.",
    "Create restore point outside the target release process.",
    "Capture rollback command and owner before applying changes."
  ],
  "dummy_machine_tests": [
    "Install release in disposable workspace or VM.",
    "Run gateway smoke, cron dry-run, and representative skill self-tests.",
    "Compare before/after logs and abort on new high findings."
  ],
  "mutated_files": []
}

Marketing copy

Runtime Fit Preflight Doctor gives OpenClaw operators a practical upgrade safety gate before production changes. It scans workspace readiness markers and release notes for breaking changes, gateway risk, cron impact, dependency churn, and rollback gaps, then returns a clear SAFE/WARN/BLOCKED decision with restore-point and dummy-machine test guidance — all local, read-only, and dependency-free.

Runtime Fit Preflight Doctor