@ralph-orchestrator/ralph-cli 2.6.0 → 2.8.0

package/CHANGELOG.md

@@ -2,6 +2,58 @@
 
 All notable changes to ralph-orchestrator are documented here.
 
+The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/), and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
+
+## [Unreleased]
+
+## [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
+
+### Added
+
+- Per-project orchestrator lifecycle hooks v1.
+- `kiro-acp` backend with ACP executor support.
+- Subprocess TUI over JSON-RPC stdin/stdout.
+- Improved TUI tool rendering for ACP-backed flows.
+
+### Changed
+
+- Simplified internal code paths by removing redundant clones and deduplicating `now_ts`.
+- Replaced deprecated `Duration` method usage with `from_secs`.
+- `ralph plan` PDD SOP now syncs from the canonical `strands-agents/agent-sop` upstream source, with a small Ralph-specific loop handoff addendum.
+- Added embedded asset sync, check, and upstream refresh helpers for SOP maintenance.
+- Unified and modernized preset documentation.
+- Added `llms.txt` map generation and CI validation.
+- Hardened web `tsx` preflight behavior and added funding metadata.
+
+### Fixed
+
+- Avoid self-lock contention in subprocess TUI mode.
+- Accumulate Pi text deltas into flowing paragraphs in the TUI.
+- Clean up zombie worktree loops more reliably.
+- Fix ACP orphaned processes, garbled TUI output, and missing tool details.
+- Resolve clippy issues and missing struct fields.
+
 ## [2.6.0] - 2026-02-25
 
 ### Added
@@ -106,6 +158,9 @@ All notable changes to ralph-orchestrator are documented here.
 
 - Modularized codebase and fixed TUI mode
 
+[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
 [2.6.0]: https://github.com/mikeyobrien/ralph-orchestrator/compare/v2.5.1...v2.6.0
 [2.5.1]: https://github.com/mikeyobrien/ralph-orchestrator/compare/v2.5.0...v2.5.1
 [2.3.0]: https://github.com/mikeyobrien/ralph-orchestrator/compare/v2.2.5...v2.3.0

package/README.md

@@ -72,6 +72,24 @@ ralph web --frontend-port 8080         # custom frontend port
 ralph web --legacy-node-api            # opt into deprecated Node tRPC backend
 ```
 
+### 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:**
 - Rust toolchain (for `ralph-api`)
 - Node.js >= 18 + npm (for the frontend)
@@ -99,6 +117,16 @@ npm run dev:legacy-server  # deprecated Node backend (optional)
 npm run test             # all frontend/backend workspace tests
 ```
 
+## 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?
 
 Ralph implements the [Ralph Wiggum technique](https://ghuntley.com/ralph/) — autonomous task completion through continuous iteration. It supports:
@@ -107,7 +135,7 @@ Ralph implements the [Ralph Wiggum technique](https://ghuntley.com/ralph/) — a
 - **Hat System** — Specialized personas coordinating through events
 - **Backpressure** — Gates that reject incomplete work (tests, lint, typecheck)
 - **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
 
 ## RObot (Human-in-the-Loop)
 

package/npm-shrinkwrap.json

@@ -23,7 +23,7 @@
       "hasInstallScript": true,
       "license": "MIT",
       "name": "@ralph-orchestrator/ralph-cli",
-      "version": "2.6.0"
+      "version": "2.8.0"
     },
     "node_modules/@isaacs/balanced-match": {
       "engines": {
@@ -515,5 +515,5 @@
     }
   },
   "requires": true,
-  "version": "2.6.0"
+  "version": "2.8.0"
 }

package/package.json

@@ -1,5 +1,5 @@
 {
-  "artifactDownloadUrl": "https://github.com/mikeyobrien/ralph-orchestrator/releases/download/v2.6.0",
+  "artifactDownloadUrl": "https://github.com/mikeyobrien/ralph-orchestrator/releases/download/v2.8.0",
   "bin": {
     "ralph": "run-ralph.js"
   },
@@ -62,7 +62,7 @@
       "zipExt": ".tar.xz"
     }
   },
-  "version": "2.6.0",
+  "version": "2.8.0",
   "volta": {
     "node": "18.14.1",
     "npm": "9.5.0"