Skip to content

RaiSE 3.1.0 Release Candidate — Release Notes

Archived — superseded by 3.1.0

The release-candidate line is closed. 3.1.0 is the current release; see the 3.1.0 release notes. If you are still on rc3, rc4 or rc5, follow the upgrade guide.

This page is kept for historical reference. The install commands below pin a superseded prerelease and are not the recommended way to install RaiSE.

The rc line closed at 3.1.0rc5. The beta period (b1, b2) uncovered bugs in the pipeline engine, session lifecycle, and phase telemetry that were resolved across the rc line. RC5 was the final release candidate before 3.1.0.

Installing the release candidate

Superseded — install 3.1.0 instead. Retained for reference:

# Linux / macOS
curl -fsSL https://github.com/humansys/raise/releases/latest/download/install.sh | bash -s -- --version v3.1.0rc5

# Windows (PowerShell)
irm https://github.com/humansys/raise/releases/latest/download/install.ps1 | iex -Version v3.1.0rc5

After installing the binary, sync your project's skills and hooks:

cd your-project
rai upgrade

What changed since rc3

Added

  • Developer portal (RAISE-16382) — static HTML portal generated from the repo: 185 ADRs rendered as navigable decision pages, patterns how-to guide, curated showcase, 5 evergreen onboarding pages, full-text search index with CI freshness gate.
  • raise-admin project portal (RAISE-16479) — vertical-slice project portal with project overview (stats, recent pipelines, activity), pipelines tab, activity tab, and navigation hardening with sub-nav and per-route error boundaries.
  • Server project-scoped queries (RAISE-16475) — project_id added to pipeline runs schema (see schema migration note below), project stats endpoint, and activity-feed project filter.

Changed

  • CLI layer model: hook_bus to foundation tier (RAISE-16455) — hook_bus extracted to T5 foundation; MAX_WAIVERS ratchet 20 → 17.
  • CLI layer model: embeddings to foundation tier (RAISE-16457) — OnnxEmbeddingProvider relocated to new embeddings T5 package; MAX_WAIVERS ratchet 21 → 20.
  • CLI layer model: 3 XS waivers removed (RAISE-16509) — MAX_WAIVERS ratchet 17 → 14. rai-admin frontend migrated to TanStack Query (RAISE-16476); projectsBus removed.
  • DDD ontological alignment (RAISE-16484) — spike documenting domain-driven design concept mapping to the RaiSE governance model.

Fixed (accumulated since rc1)

  • httpx2 migration (RAISE-16391), AsyncMock warnings (RAISE-16390), SQLAlchemy 2.0 row API (RAISE-16392) — raise-server test suite clean.
  • Windows: pid_alive() broadcast signal (RAISE-16347) — os.kill(pid, 0) replaced with OpenProcess check; no longer sends CTRL_C to the whole group.
  • CI diagram fidelity gate (RAISE-16419) — Mermaid reserved-keyword failures fixed.
  • Delegated pipeline rendering (RAISE-16426) — compact PIR, correct token for delegated child pipelines.

Upgrading from rc3

RC5 is a drop-in upgrade for CLI users. Server operators should read the schema migration note below.

# 1. Upgrade the binary
curl -fsSL https://github.com/humansys/raise/releases/latest/download/install.sh | bash

# 2. Sync skills, hooks, and config inside every project
cd your-project
rai upgrade

Schema migration (server operators only)

RAISE-16475 adds a nullable project_id column and composite index to the pipeline_runs table. The migration is automatic and additive:

  • Runs automatically on server restart (alembic upgrade head on dev; Cloud Run migrate job on production).
  • No data loss — the column is nullable; existing rows are unaffected.
  • Downgrade supported — alembic downgrade drops the column and index cleanly.
  • No action needed for CLI-only users. Only affects teams running raise-server.

Backup before migrating (large deployments)

If your deployment has a large pipeline_runs table, take a database snapshot before restarting the server. The migration is safe and tested, but a snapshot costs nothing.

What changed since rc1

See the rc1 notes and the full changelog for fixes between rc1 and rc3 (RAISE-16382, RAISE-16391, RAISE-16390, RAISE-16392, RAISE-16347, RAISE-16419, RAISE-16426).

What changed since beta (b2)

Fixed

  • Pipeline start decoupled from MCP server root (RAISE-15781) — worktrees of the same repository were rejected by the MCP identity check because it compared --show-toplevel (per-worktree) instead of --git-common-dir (per-repo). A new rai pipeline start CLI command provides a fallback entry point independent of MCP transport.

Known issues

See Known issues.

Full changelog

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