Releases: Rubiss-Projects/spec-kit-ralph
Releases · Rubiss-Projects/spec-kit-ralph
Release list
v1.2.1
Fixed
- Corrected the required Spec Kit version to
>=0.8.5so 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.1release.
v1.2.0
Added
- Official Claude Code support via a dedicated
claudeinvocation path (--dangerously-skip-permissions) in both Bash and PowerShell orchestrators (#8) - Regression coverage for Claude CLI detection and the Claude iteration codepath
Changed
- Documented
claudeas a supportedagent_clivalue and marked it as an optional tool requirement
Fixed
- PowerShell Copilot dispatch now reads Spec Kit's nested
integration_settings.copilotsettings, so skills-mode repositories invoke/speckit-ralph-iterateinstead of the dottedspeckit.ralph.iterateagent. - Agent CLI detection now works on bash 3.2 (the default on macOS); the previous
${var,,}lowercasing failed withbad substitution, causing everyagent_clito be reported as unsupported - Claude iterations now pass the
speckit.ralph.iteratecommand 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
Fixed
- Hardened
speckit.ralph.runso free-form launcher text likeImplement US1is warned about and ignored, preventing the host agent from implementing tasks inline instead of launching the Ralph loop (#18).
v1.1.1
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
Added
- Official Codex CLI support via a dedicated
codex execinvocation path in both Bash and PowerShell orchestrators - Regression coverage for agent CLI detection and Codex prompt assembly
Changed
- Documented supported
agent_clivalues and marked Copilot/Codex tool requirements as alternative optional agent CLIs
v1.0.2
Changed
- Updated repository references from
Rubiss/spec-kit-ralphtoRubiss-Projects/spec-kit-ralphafter the repository transfer - Updated the README installation example to point at the
v1.0.2release archive
v1.0.1
Added
- Two-workflow release pipeline:
release.yml(workflow_dispatch) creates a version-bump PR, andrelease-publish.ymlcreates 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_countinralph-loop.shreturning"0 0"instead of"0"when no incomplete tasks exist —grep -coutputs"0"with exit code 1, then|| echo 0duplicated it (#1)- Hardcoded
model: Claude Haiku 4.5 (copilot)inrun.mdfrontmatter preventing use with non-Copilot CLIs or setups without Haiku access (#1)
v1.0.0
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 terminalspeckit.ralph.iterate— single-iteration agent command that completes one work unit fromtasks.md, commits, and updatesprogress.md
Orchestrator Scripts
ralph-loop.ps1— PowerShell orchestrator for Windows with real-time agent output streamingralph-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 withmodel,max_iterations, andagent_clisettings- Environment variable overrides:
SPECKIT_RALPH_MODEL,SPECKIT_RALPH_MAX_ITERATIONS,SPECKIT_RALPH_AGENT_CLI
Hooks
after_taskshook for optional post-task-generation loop start
Project Files
README.mdwith installation, usage (agent command + direct script), configuration reference, loop architecture diagram, and extension structureCONTRIBUTING.mdwith PR guidelinesLICENSE(MIT)CODEOWNERS— auto-request review from@Rubiss.extensionignore— excludes.github/,.specify/,.vscode/, andspecs/from extension packaging.gitignorefor 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