		@@ -9,2 +9,23 @@ # Changelog

		## [2.8.0] - 2026-03-10

		### Added

		- `ralph mcp serve` for exposing Ralph as a workspace-scoped MCP server over stdio.
		- User-scoped default config discovery and support for per-user Ralph defaults.
		- TUI update availability notices in the header.
		- Human guidance can now trigger a clean restart request flow.

		### Changed

		- Consolidated the core preset set around the maintained workflows and refreshed preset docs, examples, and evaluation tooling.
		- Refined PDD and code-task guidance to reduce Ralph-specific noise and improve handoff quality.

		### Fixed

		- Hardened multi-hat preset event contracts, late-event recovery, active hat display, and downstream debug/review handoffs.
		- Preserved runtime limits from core config when using hats.
		- Fixed headless loop runner backend selection.
		- Made restart resumption use the required single-command shell flow and added contract coverage for it.

		## [2.7.0] - 2026-03-06
		@@ -141,3 +162,4 @@

		[Unreleased]: https://github.com/mikeyobrien/ralph-orchestrator/compare/v2.7.0...HEAD
		[Unreleased]: https://github.com/mikeyobrien/ralph-orchestrator/compare/v2.8.0...HEAD
		[2.8.0]: https://github.com/mikeyobrien/ralph-orchestrator/compare/v2.7.0...v2.8.0
		[2.7.0]: https://github.com/mikeyobrien/ralph-orchestrator/compare/v2.6.0...v2.7.0
		@@ -144,0 +166,0 @@ [2.6.0]: https://github.com/mikeyobrien/ralph-orchestrator/compare/v2.5.1...v2.6.0

+2

-2

npm-shrinkwrap.json

		@@ -26,3 +26,3 @@ {
		"name": "@ralph-orchestrator/ralph-cli",
		"version": "2.7.0"
		"version": "2.8.0"
		},
		@@ -519,3 +519,3 @@ "node_modules/@isaacs/balanced-match": {
		"requires": true,
		"version": "2.7.0"
		"version": "2.8.0"
		}

+2

-2

package.json

		{
		"artifactDownloadUrl": "https://github.com/mikeyobrien/ralph-orchestrator/releases/download/v2.7.0",
		"artifactDownloadUrl": "https://github.com/mikeyobrien/ralph-orchestrator/releases/download/v2.8.0",
		"bin": {
		@@ -65,3 +65,3 @@ "ralph": "run-ralph.js"
		},
		"version": "2.7.0",
		"version": "2.8.0",
		"volta": {
		@@ -68,0 +68,0 @@ "node": "18.14.1",

+29

-1

README.md

		@@ -75,2 +75,20 @@ <!-- 2026-01-28 -->

		### MCP Server Workspace Scope

		`ralph mcp serve` is scoped to a single workspace root per server instance.

		```bash
		ralph mcp serve --workspace-root /path/to/repo
		```

		Precedence is:

		1. `--workspace-root`
		2. `RALPH_API_WORKSPACE_ROOT`
		3. current working directory

		For multi-repo use, run one MCP server instance per repo/workspace. Ralph's current
		control-plane APIs persist config, tasks, loops, planning sessions, and collections
		under a single workspace root, so server-per-workspace is the deterministic model.

		Requirements:
		@@ -103,2 +121,12 @@ - Rust toolchain (for `ralph-api`)

		## MCP Server Mode

		Ralph can run as an MCP server over stdio for MCP-compatible clients:

		```bash
		ralph mcp serve
		```

		Use this mode from an MCP client configuration rather than an interactive terminal workflow.

		## What is Ralph?
		@@ -112,3 +140,3 @@
		- Memories & Tasks — Persistent learning and runtime work tracking
		- 31 Presets — TDD, spec-driven, debugging, and more
		- 5 Supported Builtins — `code-assist`, `debug`, `research`, `review`, and `pdd-to-code-assist`, with more patterns documented as examples

		@@ -115,0 +143,0 @@ ## RObot (Human-in-the-Loop)

@ralph-orchestrator/ralph-cli - npm Package Compare versions

New alerts