v0.6.5

Release notes (manual loop preflight command)

• Added /ralphi-loop-validate command to run loop preflight checks without starting a loop.
• Uses the same runtime prerequisite validation as /ralphi-loop-start.

Validation

• npm run check passed
• pre-commit hook passed during commit

v0.6.4

Release notes (loop preflight safeguards)

• Added runtime preflight validation before /ralphi-loop-start.
• Loop start now fails fast when prerequisites are missing:
  • .ralphi/config.yaml with at least one commands entry
  • valid .ralphi/prd.json (branchName, non-empty userStories, valid story id/title/status)
  • git repository
  • pre-commit wiring that enforces ralphi check
• Branch orchestration remains runtime-managed after preflight.

Validation

• npm run check passed
• pre-commit hook passed during commit

v0.6.3

Release notes (runtime branch orchestration)

• Moved PRD branch management from loop skill prompts into runtime.
• On /ralphi-loop-start, runtime now:
  • switches to existing PRD branchName, or
  • prompts in TUI to create missing branch from main or current branch.
• Added unit tests covering existing branch switching and missing-branch base selection.

Validation

• npm run check passed
• local pre-commit hook verified (prek + ralphi check)

v0.6.2

Release notes (command wording cleanup)

• Updated skill guidance to use the correct command: ralphi check.
• Removed stale ralphi ralph ... wording from init/loop skill instructions.

Validation

• Verified local pre-commit hook is installed and passing (prek + ralphi check).

v0.6.1

Release notes (status display + Pi-native init cleanup)

• Removed the ralphi-timing below-editor widget to avoid duplicate status surfaces.
• Status is now shown via status line entries only (ralphi-loop, ralphi-phase).
• Updated ralphi-init to be Pi-native: removed engine-selection prompt, default engine=pi, and removed Claude alias/symlink guidance.

v0.6.0

Release notes (status-only PRD progression)

• Loop story progression is now status-only: open -> in_progress -> done.
• Removed runtime fallback behavior that treated legacy passes as source-of-truth completion state.
• Converter/loop skill docs now require status + dependsOn story metadata.

Migration notes

• Breaking behavior change: update existing .ralphi/prd.json stories to use status values.
• Recommended migration: convert passes:true stories to status:done, all others to status:open (or in_progress when resumed).

v0.5.0

Release 0.5.0: runtime modularization and timing telemetry.

v0.4.0

Release notes (reflection checkpoints documentation)

• Added cadence-based reflection checkpoints in loop runtime via loop.reflectEvery and optional loop.reflectInstructions.
• Added checkpoint-only prompt injection and status countdown visibility for upcoming reflection iterations.
• Extended ralphi_phase_done with additive reflection metadata fields (reflectionSummary, nextIterationPlan) and checkpoint-only validation.
• Added runtime behavior to reset .ralphi/progress.txt when PRD branch changes and archive previous run data under .ralphi/archive/.
• Consolidated loop runtime artifacts under .ralphi/*:
  • .ralphi/prd.json
  • .ralphi/progress.txt
  • .ralphi/.last-branch

Migration notes

• Reflection checkpoints are opt-in; existing projects remain unchanged unless loop.reflectEvery is set.
• Roll out gradually by starting with a larger cadence (for example reflectEvery: 5) before tightening.
• loop.reflectInstructions should be layered in after baseline cadence adoption.
• Runtime artifact paths have moved from project root to .ralphi/*; update any scripts or tooling that reference root prd.json, progress.txt, .last-branch, or archive/.

v0.3.0

Release notes (three-phase loop guidance rollout)

• Phase 1: required loop step-back review protocol and trajectory logging format in skills/ralphi-loop/SKILL.md.
• Phase 2: project-local loop guidance in .ralphi/config.yaml (loop.guidance) plus guidance management commands.
• Phase 3: optional strict review controls in .ralphi/config.yaml (loop.reviewPasses, loop.trajectoryGuard) and additive loop metadata fields in ralphi_phase_done.
• Loop auto-completion when no prd.json stories remain with passes: false.

Migration notes

• No hard migration is required; default loop behavior continues to work.
• If you previously used ad-hoc prompt guidance, move it to .ralphi/config.yaml under loop.guidance.
• Adopt strict controls gradually:
  1. set loop.reviewPasses first,
  2. use trajectoryGuard: "warn_on_drift",
  3. move to trajectoryGuard: "require_corrective_plan" when ready.
• To return to lightweight defaults, use loop.reviewPasses: 1 and loop.trajectoryGuard: "off".

v0.2.0

Test release for automated npm trusted publishing via GitHub Actions.