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