RealStop 0.2.3 — opt-in Supervisor pilot and ancestry fixes

RealStop 0.2.3 combines the parallel Claude tool-receipt ancestry correction, packaged Supervisor library, and a narrowly scoped opt-in live pilot.

Try the pilot

Install the attached wheel with pip install /path/to/realstop-0.2.3-py3-none-any.whl or uv tool install /path/to/realstop-0.2.3-py3-none-any.whl. Verify realstop --version. Follow the contract example, then run realstop-supervisor --contract contract.json.

The pilot starts a new private Claude workspace for one explicitly authorized file. It permits at most one native-confirmed continuation and checks the final file hash. It does not attach to existing sessions or install global hooks. Compaction, ambiguous context and unsupported inputs still cause abstention. Supervisor remains experimental.

What was demonstrated

A completed-file control needed no verifier or intervention. A controlled test removed the file after a genuine Write; after native confirmation, Claude wrote it again and the final hash matched. Earlier insufficient and policy-rejected development runs remain documented. This demonstrates a bounded recovery mechanism, not natural quit-detection accuracy or broad session coverage. No new model weights are included.

The previous seven-hour session had 36 ancestry abstentions and zero verifier calls; this release does not claim it is now protected.

Validation

Full offline suite, 107 confirmed-hook tests plus 2 subtests, 3 Codex adapter tests, 96 Supervisor and 9 fixture tests, Python 3.9 compatibility and clean wheel smoke, package metadata/content/privacy checks, and hosted CI.

See the release guide for installation, rollback and limits. SHA256SUMS covers both attached distribution files. PyPI publication is separate and currently requires publishing credentials. The Hugging Face model is unchanged.

RealStop 0.2.3rc1 — experimental confirmed hooks

Experimental prerelease of the opt-in evidence-confirmed Stop hook for Claude Code and local Codex. Existing rules adapters remain available. Native-only verification is the experimental default; no model weights are included.

The monitored real session was unsupported. Over seven hours, all 36 completed checks failed ancestry parsing, with zero verifier calls and zero blocks. No real-session protection, intervention quality, or population accuracy was demonstrated. See live monitoring and confirmed-hook limits.

The synthetic held-out 48 provider variants derive from 26 unique authored packets: native-only TP18/TN24/FP0/FN6; isolated installed baseline TP2/TN22/FP2/FN22 (not production A/B); optional model cascade TP15/TN24/FP0/FN9. The classifier is not credited with native improvements. Local audit eligibility was 6/20 separate boundaries. Failed development evidence remains retained. Verdict overlap is acknowledged; the proposed Supervisor architecture is not shipped.

Validation passed: upstream offline checks, 3 Codex adapter tests, 85 confirmed-hook tests plus 2 subtests, benchmark fixture validation, source/artifact privacy checks, wheel and sdist build, isolated installation and entrypoint smoke tests. Attached artifacts contain no private session traces. Host hook trust review remains required; configuration alone does not prove activation.

PyPI upload is blocked by missing configured publishing credentials. The optional separate experimental model upload is blocked by Hugging Face organization write access (HTTP 403). No PyPI or new model publication is claimed.

RealStop 0.2.2

Package metadata only: PyPI project links, keywords and classifiers, plus the real-session demo GIF in the README. No code changes.

RealStop 0.2.1

Fixes the banner, replay GIF and repository links on the PyPI project page.

RealStop 0.2.0 — Codex CLI support

RealStop now supports main-agent turns in Codex CLI through a standalone rules adapter. It observes by default and can issue one continuation when Codex offers to do work the user already requested. The adapter keeps task fingerprints and counters locally.

Install the release wheel and enable observation:

uv tool install --upgrade https://github.com/decision-tune/realstop/releases/download/v0.2.0/realstop-0.2.0-py3-none-any.whl
realstop setup --host codex

Start a fresh Codex CLI session and use /hooks to review and trust the RealStop commands. Use realstop status --host codex to inspect the counts. To opt into continuation, run realstop setup --host codex --mode block.

Verified on Codex CLI 0.166.0 with a staged unfinished two-file task and a completed-task optional-offer control. The existing paper's performance estimates do not evaluate this adapter.