Skip to content

v0.25.0

Choose a tag to compare

@github-actions github-actions released this 04 Oct 21:07
· 308 commits to main since this release
71ee355

What's changed

Added

  • Housekeeping, from Home's SYSTEM group (H). A dry-run scan lists orphaned sprints and memory, old done
    sprints and old runs with their sizes (KiB / MiB / GiB); select what to delete and confirm. Removing a project asks
    separately whether to remove its sprints and memory too.

  • Doctor shows what to fix first. ! groups failing probes ahead of the passing ones, which ↵ reveals.

  • Crash recovery. If ralphctl dies mid-run (crash, kill -9, power loss), an interrupted task shows in
    Home's NEEDS ATTENTION group with its attempt, age and uncommitted changes; ↵ resumes Implement. Active sessions
    lists the dead run (d dismisses it). On a best-effort basis the generator continues its previous provider
    session when provider, model and working directory are unchanged, and starts from the full brief otherwise. An
    interruption does not use up a task attempt (up to three in a row).

  • Quit asks first. q on Home / ctrl+c with runs live asks [y/N] (default No) and stops them cleanly on yes,
    even when a run is waiting on your answer. A run that does not stop within 5s is force-stopped. Stopping a run
    yourself does not use up a task attempt either, and the attempt counter shows · resumed after a free restart.

  • Waiting runs say so. A run blocked on your answer shows [WAITING] in NEEDS ATTENTION, the footer and the run
    view, and fires an OS notification (honouring ui.notifications). Runs that finish after two minutes notify too.

  • Presets fit your account. Applying a preset (Settings, ralphctl settings apply-preset, first-run setup)
    now checks which models your account can actually use and swaps in a close stand-in for any it can't — e.g. a
    Copilot plan without gpt-6-luna gets gpt-5.6-luna — and says which rows changed. Copilot now asks the Copilot
    CLI for your account's models, so the Settings model picker lists only those too.

Changed

  • New models, and the presets use them. Codex and Copilot gain gpt-6.1-sol, which replaces gpt-6-sol as the
    Codex flagship in the Codex presets, the Codex defaults, the default implement evaluator and the top of the Codex
    escalation ladder (same token price). Copilot gains claude-sonnet-5.5, which replaces Sonnet 5 in the Copilot
    presets and its escalation ladder (Haiku → Sonnet 5.5 → Opus 4.8). Copilot's light flows move from gpt-5.6-luna
    to gpt-6-luna (half the price). On Copilot, gpt-6.1-sol is Pro+ only, so no Copilot preset uses it.
  • Copilot models GitHub retired on 2026-10-02 are gone. gemini-3.5-flash / gemini-3.6-flash →
    gemini-3.8-flash, kimi-k2.7-code → kimi-k3, claude-opus-4.7 → claude-opus-4.8; a saved setting on one of
    them is moved over on load. The models Copilot retires on 2026-10-19 (gpt-5.5, gpt-5.4, gpt-5.4-mini,
    gpt-5-mini, gemini-3.7-flash, grok-4.5) still work until then, but no preset or escalation step uses them.
  • No more orphaned AI processes. AI CLIs run in their own process group; abort and the idle watchdog stop the
    whole group, and a helper cleans up what a dead ralphctl left behind (on POSIX; on Windows the next launch
    does it). Session ids are saved as soon as the CLI reports them.
  • Stale locks recover faster. A repository lock records its owner; a dead owner on the same machine is reclaimed
    at once, and a held lock names the process that holds it.
  • Overlays outrank prompts. An open overlay stays closable while a prompt is queued, and q never quits through
    one. The header and footer clip to one line at narrow widths.

Fixed

  • Create sprint checks the name as you type. An empty, punctuation-only or too-long name (its slug may not
    exceed 64 characters) stays at the prompt with an inline error instead of failing the run.
  • Project slugs are unique. Creating a project whose slug another project already uses is refused, and the
    wizard says so at the slug step.
  • Review's distill question defaults to No, matching its [y/N] label (close sprint's too). esc on the
    feedback prompt now leaves the sprint in review without journaling a close; an empty submission still closes it.
  • Detect scripts, Detect skills and Review check the AI CLI is on PATH before starting, like the other AI
    flows, instead of failing on a spawn error.
  • progress.md's State: line follows the sprint to active, review and done.
  • Refine's unavailable reason no longer says "add at least one ticket" when every ticket is already approved.
  • Create PR checks the sprint first. An ineligible sprint is refused before anything is pushed, and if any AI
    authoring step fails the PR opens with the template text instead of failing.
  • A PR without a URL is an error. When gh / glab exits 0 without printing a URL, create PR now reports it
    instead of storing the last line of output as the PR URL.
  • Context-file writes never overwrite blind. Readiness and distill refuse to replace an existing file they
    can't read for a backup.
  • Cancelling a task settles its attempt. The running attempt is marked aborted instead of staying running.
  • Parallel implement stops after a failed setup. It no longer runs the closing steps when the prologue failed.
  • Sprint delete respects running flows. ralphctl sprint remove is refused while a flow runs, including a
    flow in another process that holds no lock.
  • A blank task description is rejected instead of silently clearing the field.
  • ralphctl task evaluation prints an error to stderr and exits 1 when the artifact can't be read.
  • Effort follows the model, not just the provider. Copilot claude-haiku-4.5 gets no effort flag (its CLI
    rejects any level), and Copilot / Codex models that support fewer levels get the closest one they accept — e.g.
    max becomes high on Copilot gpt-5-mini and xhigh on Codex gpt-5.5. A global max now reaches the Codex
    models that accept it instead of always flooring to xhigh.
  • A rejected effort or model blocks the task once, with the reason. When the AI CLI refuses the configured
    effort or model, the task blocks after one attempt and names the setting to change (e.g.
    ai.implement.generator.effort), instead of retrying until "AI process repeatedly crashed". Codex errors that it
    reports only on stdout are now read too.

Removed

  • scm.postRefinementComment setting. It had no effect; existing settings files still load and drop it.

Full changelog: v0.25.0...HEAD
npm: https://www.npmjs.com/package/ralphctl/v/0.25.0