Skip to content

Releases: Rubiss-Projects/spec-kit-ralph

v1.2.1

Choose a tag to compare

@github-actions github-actions released this 04 Jul 18:50

Fixed

  • Corrected the required Spec Kit version to >=0.8.5 so installs enforce the Copilot skills-mode integration metadata required by Ralph's dispatch logic.
  • Updated compatibility documentation and direct archive install examples for the v1.2.1 release.

v1.2.0

Choose a tag to compare

@github-actions github-actions released this 04 Jul 18:28

Added

  • Official Claude Code support via a dedicated claude invocation path (--dangerously-skip-permissions) in both Bash and PowerShell orchestrators (#8)
  • Regression coverage for Claude CLI detection and the Claude iteration codepath

Changed

  • Documented claude as a supported agent_cli value and marked it as an optional tool requirement

Fixed

  • PowerShell Copilot dispatch now reads Spec Kit's nested integration_settings.copilot settings, so skills-mode repositories invoke /speckit-ralph-iterate instead of the dotted speckit.ralph.iterate agent.
  • Agent CLI detection now works on bash 3.2 (the default on macOS); the previous ${var,,} lowercasing failed with bad substitution, causing every agent_cli to be reported as unsupported
  • Claude iterations now pass the speckit.ralph.iterate command text in the prompt instead of --agent speckit.ralph.iterate; Claude Code has no registered agent to select, so the old invocation always failed
  • Completion signal is now recognized only when <promise>COMPLETE</promise> stands alone on a line, so agents mentioning the token in prose (e.g. "no <promise>COMPLETE</promise>") no longer terminate the loop prematurely

v1.1.2

Choose a tag to compare

@github-actions github-actions released this 19 Jun 22:02

Fixed

  • Hardened speckit.ralph.run so free-form launcher text like Implement US1 is warned about and ignored, preventing the host agent from implementing tasks inline instead of launching the Ralph loop (#18).

v1.1.1

Choose a tag to compare

@github-actions github-actions released this 05 Jun 03:11

Fixed

  • Install-time Ralph config placement now targets .specify/extensions/ralph/ralph-config.yml, matching the path loaded by the orchestrator scripts.

v1.1.0

Choose a tag to compare

@github-actions github-actions released this 01 Jun 22:56

Added

  • Official Codex CLI support via a dedicated codex exec invocation path in both Bash and PowerShell orchestrators
  • Regression coverage for agent CLI detection and Codex prompt assembly

Changed

  • Documented supported agent_cli values and marked Copilot/Codex tool requirements as alternative optional agent CLIs

v1.0.2

Choose a tag to compare

@github-actions github-actions released this 01 May 22:32

Changed

  • Updated repository references from Rubiss/spec-kit-ralph to Rubiss-Projects/spec-kit-ralph after the repository transfer
  • Updated the README installation example to point at the v1.0.2 release archive

v1.0.1

Choose a tag to compare

@github-actions github-actions released this 12 Apr 19:16

Added

  • Two-workflow release pipeline: release.yml (workflow_dispatch) creates a version-bump PR, and release-publish.yml creates the tag and GitHub Release when the PR merges — respects branch protection without elevated tokens
  • .github/workflows/tests.yml — CI workflow running bash tests on Ubuntu and PowerShell tests on Windows for PRs and pushes to main
  • Regression test suites: 25 bash tests (tests/regression/bash/) and 26 PowerShell tests (tests/regression/powershell/)

Fixed

  • get_incomplete_task_count in ralph-loop.sh returning "0 0" instead of "0" when no incomplete tasks exist — grep -c outputs "0" with exit code 1, then || echo 0 duplicated it (#1)
  • Hardcoded model: Claude Haiku 4.5 (copilot) in run.md frontmatter preventing use with non-Copilot CLIs or setups without Haiku access (#1)

v1.0.0

Choose a tag to compare

@Rubiss Rubiss released this 09 Mar 03:59

Added

Extension Manifest

  • extension.yml — schema v1.0 manifest declaring 2 commands, 1 hook, 1 config template, and tool requirements (copilot, git)

Commands

  • speckit.ralph.run — thin launcher that validates prerequisites, resolves configuration, and launches the platform-appropriate orchestrator script in a visible terminal
  • speckit.ralph.iterate — single-iteration agent command that completes one work unit from tasks.md, commits, and updates progress.md

Orchestrator Scripts

  • ralph-loop.ps1 — PowerShell orchestrator for Windows with real-time agent output streaming
  • ralph-loop.sh — Bash orchestrator for macOS/Linux with real-time agent output streaming
  • 5-layer configuration precedence: extension defaults → project config → local config → environment variables → CLI parameters
  • 3-consecutive-failure circuit breaker
  • Graceful Ctrl+C / SIGINT handling (exit code 130)
  • Summary block on all 4 termination paths (completed, interrupted, failed, iteration limit)
  • Cross-iteration progress tracking via progress.md

Configuration

  • ralph-config.template.yml — config template with model, max_iterations, and agent_cli settings
  • Environment variable overrides: SPECKIT_RALPH_MODEL, SPECKIT_RALPH_MAX_ITERATIONS, SPECKIT_RALPH_AGENT_CLI

Hooks

  • after_tasks hook for optional post-task-generation loop start

Project Files

  • README.md with installation, usage (agent command + direct script), configuration reference, loop architecture diagram, and extension structure
  • CONTRIBUTING.md with PR guidelines
  • LICENSE (MIT)
  • CODEOWNERS — auto-request review from @Rubiss
  • .extensionignore — excludes .github/, .specify/, .vscode/, and specs/ from extension packaging
  • .gitignore for local config and build artifacts

Spec Documentation

  • Full spec-kit design artifacts under specs/001-port-ralph-extension/: spec, plan, research, data model, quickstart, tasks, requirements checklist, and contracts (command schemas, config schema, extension manifest)

Full Changelog: https://github.com/Rubiss/spec-kit-ralph/commits/v1.0.0