ralph-loop-control-plane v1.0

What it does

ralph-loop-control-plane is a governance checker for long-running autonomous agent loops. It reviews a JSON loop plan before launch and blocks plans that are missing finite iteration/time caps, useful stop conditions, human approval gates, logging, heartbeat cadence, rollback planning, or budget controls.

It does not start agents, spawn subprocesses, create cron jobs, call networks, approve actions, or mutate anything except an explicit policy/output file when the user chooses that mode.

Best fit

Pre-launch review for Ralph-loop / heartbeat-loop style automations.
Safety sign-off for recurring agent jobs that could otherwise run unbounded.
Operator checklists before external sends, deploys, destructive writes, or spend.

Requirements

Python 3.10+
Standard library only
No API keys
No network access

Example usage

Create a bounded plan:


{
  "goal": "triage release blockers",
  "max_iterations": 5,
  "max_minutes": 20,
  "budget_usd": 1,
  "heartbeat_minutes": 5,
  "stop_conditions": ["complete", "error", "budget timeout", "human approval required"],
  "approval_gates": ["external sends", "delete/write/deploy", "spend"],
  "log_path": "logs/loop.jsonl",
  "rollback_plan": "stop loop and restore previous artifact"
}

Run the validator:


python3 skills/ralph-loop-control-plane/scripts/ralph_loop_control_plane.py /tmp/loop-plan.json --json

Expected good-plan result:


{
  "tool": "ralph-loop-control-plane",
  "verdict": "approved_to_run",
  "governance_score": 100,
  "issues": []
}

Unsafe or incomplete plans return revise_before_run or blocked_unbounded_loop with severity-ranked fixes.

Security and QA evidence

Viper QA 2026-05-10: PASS 5/5 — bounded plans approve, unbounded plans block, weak gates revise, malformed/non-object JSON exits cleanly.
Warlock security audit 2026-05-10: SECURITY_CLEARED — local JSON validation only; no subprocess, network, eval/exec, autonomous execution, or credential access.
Dependency risk: LOW — Python standard library only.
Evidence files: memory/viper-test-results-2026-05-10.md, memory/warlock-security-audit-2026-05-10.md.

Release status

Hollywood release prep complete on 2026-05-10. Ready for Rooster packaging/listing when Stripe credentials and production publish gates are available.

Price

$4.99

Ralph Loop Control Plane