Skip to content

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