@ralph-orchestrator/ralph-cli 2.9.3 → 2.10.0

package/CHANGELOG.md

@@ -4,11 +4,61 @@ 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.10.0] - 2026-06-21
+
+### Added
+
+- Forge CLI backend integration.
+- RObot (human-in-the-loop) RPC domain in the control plane, plus a file-backed web mode that drives human interaction through files instead of a live socket.
+- Worktree loops can publish remote review branches, with rebase support.
+- Local file-based hat imports in preflight, including import resolution and schema validation with imported-file context.
+- On-demand export of TUI iteration buffers to disk: `e` exports the current iteration, `E` exports all iterations.
+- Context-window utilization telemetry, surfaced in the TUI.
+
+### Changed
+
+- Updated the Pi backend package reference to `@earendil-works/pi-coding-agent`.
+- Refreshed agent waves observability documentation and added the hat imports design spec.
+
+### Fixed
+
+- TUI search mode now captures typed query characters instead of leaking them to keybindings (e.g. an `e` in the query no longer triggers export); the `Search:` prompt, `N/M` match counter, and `n`/`N` navigation work again.
+- Runtime now requires an explicit completion signal after guidance, preventing premature loop termination.
+- Persist loop continue state across iterations.
+- Honor per-hat scratchpad configuration in generated instructions.
+- Drain ACP terminal output before exit so the final output is no longer truncated.
+- Canonicalize Ralph artifact paths to avoid path-mismatch errors.
+- Deduplicate MCP tool schemas exposed over the API.
+
+## [2.9.3] - 2026-05-08
+
+### Added
+
+- `ralph-docs` skill for `llms.txt`-driven introspection.
+- Unified preset mechanism under `-H <name>`, supporting both YAML and TOML presets.
+- `ralph plan` support for the kiro-acp backend, including a completion fallback.
+- Visual workflow editor (builder) with live agent observation.
+- Per-hat scratchpad configuration.
+- Hats can set a cancellation promise.
+- Improved `--no-tui` UX with a loop banner, per-iteration footer, and resume hint.
+
+### Changed
+
+- Switched Linux distribution targets to musl for Amazon Linux 2 / 2023 compatibility.
+- Documented global user config for hooks, added an FAQ section, and linked the autoloop authoring guide for the TOML preset format.
 
 ### Fixed
 
 - Claude child sessions now default to `--setting-sources project,local`, preventing host user-level `~/.claude/settings.json` hooks, plugins, and MCP servers from leaking into Ralph orchestration runs. Users who want the old behavior can opt back in with `cli.args: ["--setting-sources", "user,project,local"]`.
+- Route the text completion fallback through `check_completion_event()`.
+- Propagate the `RALPH_EVENTS_FILE` env var and preserve late termination reasons.
+- Prevent lingering text backends from stalling loop progression.
+- Resolve Rust 1.95 `duration_suboptimal_units` clippy warnings.
+
+### Security
+
+- Replaced `source` with a safe variable parser in `sync-embedded-files.sh`.
+- Use `npm ci` instead of `npm install` in `test-fresh-install.sh`.
 
 ## [2.9.2] - 2026-04-10
 

package/README.md

@@ -46,10 +46,10 @@ ralph init --backend claude
 
 # 2. Plan your feature (interactive PDD session)
 ralph plan "Add user authentication with JWT"
-# Creates: specs/user-authentication/requirements.md, design.md, implementation-plan.md
+# Creates: .ralph/specs/user-authentication/requirements.md, design.md, implementation-plan.md
 
 # 3. Implement the feature
-ralph run -p "Implement the feature in specs/user-authentication/"
+ralph run -p "Implement the feature in .ralph/specs/user-authentication/"
 ```
 
 Ralph iterates until it outputs `LOOP_COMPLETE` or hits the iteration limit.
@@ -135,7 +135,7 @@ Use this mode from an MCP client configuration rather than an interactive termin
 
 Ralph implements the [Ralph Wiggum technique](https://ghuntley.com/ralph/) — autonomous task completion through continuous iteration. It supports:
 
-- **Multi-Backend Support** — Claude Code, Kiro, Gemini CLI, Codex, Amp, Copilot CLI, OpenCode
+- **Multi-Backend Support** — Claude Code, Kiro, Gemini CLI, Codex, Forge, Amp, Copilot CLI, OpenCode
 - **Hat System** — Specialized personas coordinating through events
 - **Backpressure** — Gates that reject incomplete work (tests, lint, typecheck)
 - **Memories & Tasks** — Persistent learning and runtime work tracking
@@ -213,11 +213,11 @@ Homebrew is not currently published from this repository's automated release flo
 ```bash
 ralph init --backend claude
 ralph plan "Add user authentication with JWT"
-ralph run -p "Implement the feature in specs/user-authentication/"
+ralph run -p "Implement the feature in .ralph/specs/user-authentication/"
 ```
 
 **What backends does Ralph support?**
-Claude Code, Kiro, Gemini CLI, Codex, Amp, Copilot CLI, and OpenCode.
+Claude Code, Kiro, Gemini CLI, Codex, Forge, Amp, Copilot CLI, and OpenCode.
 
 **What is the "hat system"?**
 Ralph uses specialized personas (hats) that coordinate through events. Each hat has a specific role — code-assist, debug, research, review, and pdd-to-code-assist — enabling structured multi-step task execution.

package/npm-shrinkwrap.json

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

package/package.json

@@ -1,5 +1,5 @@
 {
-  "artifactDownloadUrl": "https://github.com/mikeyobrien/ralph-orchestrator/releases/download/v2.9.3",
+  "artifactDownloadUrl": "https://github.com/mikeyobrien/ralph-orchestrator/releases/download/v2.10.0",
   "bin": {
     "ralph": "run-ralph.js"
   },
@@ -90,7 +90,7 @@
       "zipExt": ".tar.xz"
     }
   },
-  "version": "2.9.3",
+  "version": "2.10.0",
   "volta": {
     "node": "18.14.1",
     "npm": "9.5.0"