Skip to content

RaiSE 3.1.0 Beta — Release Notes

First public beta of the RaiSE 3.1 line. The current beta build is 3.1.0b2; this page covers the beta line as a whole (b1 + b2). Stable remains 3.0.0 on PyPI.

Installing the beta

Follow the installation guide — the install script uses the beta channel by default:

curl -LsSf https://docs.raiseframework.ai/install.sh | bash

Upgrading from 3.0? Read the Upgrading section of the installation guide first: 3.1 rebuilds the knowledge graph (schema v68), renames the RAI_* environment variables to RAISE_*, and scopes session continuity to worktree + agent.

Highlights

  • Worktree lifecycle — rai worktree register/list/close for multi-worktree development with session isolation and propagation.
  • Full cross-harness parity — Codex CLI and Kimi expose the same 36 MCP tools as Claude Code; Codex gains PostToolUse staleness detection (RAISE-14908).
  • Mechanical scope guard — rai discover scan output is scoped to the current checkout; cross-worktree symbol leakage is closed (RAISE-15618).
  • Codex plugin distribution for initialized and upgraded projects, including a local marketplace manifest and the raise-governance plugin surface.
  • Stateless workspace MCP execution with explicit project/worktree context and coherent harness configuration.

Behavior changes

  • Session continuity is scoped to worktree + agent — a session only inherits continuity from the last session closed in the same worktree, with the agent session id as tie-breaker. The project-wide "last closed session" fallback was removed. Main-checkout users with pre-V67 history get a clean start instead of inheriting an unrelated session.
  • Release governance enforces prerequisite ordering, bounded suppression growth, and post-retry stop conditions.
  • Session ids gain an entropy suffix to prevent minute-collisions between concurrent sessions (RAISE-15482).

Notable fixes

  • SQLite WAL write-lock (RAISE-15605) — orphaned BEGIN transactions from failed schema migrations blocked all writers for the life of the process.
  • Graph scoped by checkout (RAISE-15607) — KG queries no longer return symbols from other worktrees.
  • Windows: bare rai no longer crashes (RAISE-15650) — the cockpit imported Unix-only modules at import time; it now prints the available commands instead of dying with a traceback.
  • Windows: rai gate check works (RAISE-15653) — the worker-budget ledger no longer requires the Unix-only fcntl to start; it selects a locking backend at runtime.
  • Install scripts can actually install the beta (RAISE-15651, RAISE-15670) — the published installers default to the pre-release channel and leave an existing project .venv untouched.
  • rai init --force no longer wipes cartridge content (RAISE-15655) — it overwrites only what the bundle owns.
  • rai cartridge reports live node counts (RAISE-15615) with checkout-wins visibility.
  • Plus hundreds of additional bug fixes across 13 subsystems since 3.1.0a1.

Known issues

See Known issues — 3.1.0 Beta.

Full changelog

The authoritative, per-package changelog ships with the package (packages/raise-cli/CHANGELOG.md in the raise-commons repository).