@arvorco/relentless 0.5.0 → 0.5.2

package/CHANGELOG.md

@@ -5,6 +5,23 @@ All notable changes to Relentless will be documented in this file.
 The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
 and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
+## [0.5.2](https://github.com/ArvorCo/Relentless/releases/tag/v0.5.2) - 2026-01-23
+
+### Fixed
+- **PRD Schema**: ExecutionHistory fields now have sensible defaults for partial execution states
+  - `attempts`, `escalations`, `actualCost` now default to 0/[] instead of being required
+  - `actualHarness` and `actualModel` are now optional (only set on completion)
+  - Fixes ZodError when loading PRDs with interrupted or in-progress executions
+
+## [0.5.1](https://github.com/ArvorCo/Relentless/releases/tag/v0.5.1) - 2026-01-23
+
+### Changed
+- **Model Registry**: Updated Claude model identifiers to use stable aliases instead of dated versions (#6 - thanks @aruj0!)
+  - `claude-sonnet-4-5-20250929` → `claude-sonnet-4-5-latest`
+  - `claude-opus-4-5-20251101` → `claude-opus-4-5-latest`
+  - `claude-haiku-4-5-20250810` → `claude-haiku-4-5-latest`
+  - This ensures compatibility as Anthropic updates model versions
+
 ## [0.5.0](https://github.com/ArvorCo/Relentless/releases/tag/v0.5.0) - 2026-01-23
 
 ### Major Features
@@ -446,7 +463,9 @@ Relentless evolved from the [Ralph Wiggum Pattern](https://ghuntley.com/ralph/)
 - **License**: MIT
 - **Inspiration**: [Ralph Wiggum Pattern](https://ghuntley.com/ralph/) by Geoffrey Huntley
 
-[Unreleased]: https://github.com/ArvorCo/Relentless/compare/v0.5.0...HEAD
+[Unreleased]: https://github.com/ArvorCo/Relentless/compare/v0.5.2...HEAD
+[0.5.2]: https://github.com/ArvorCo/Relentless/compare/v0.5.1...v0.5.2
+[0.5.1]: https://github.com/ArvorCo/Relentless/compare/v0.5.0...v0.5.1
 [0.5.0]: https://github.com/ArvorCo/Relentless/compare/v0.4.5...v0.5.0
 [0.4.5]: https://github.com/ArvorCo/Relentless/compare/v0.4.3...v0.4.5
 [0.4.3]: https://github.com/ArvorCo/Relentless/compare/v0.4.2...v0.4.3

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@arvorco/relentless",
-  "version": "0.5.0",
+  "version": "0.5.2",
   "description": "Universal AI agent orchestrator - works with Claude Code, Amp, OpenCode, Codex, Droid, and Gemini",
   "type": "module",
   "publishConfig": {

package/relentless/prompt.md

@@ -1,42 +1,34 @@
-<!-- TEMPLATE_VERSION: 2.1.0 -->
-<!-- LAST_UPDATED: 2026-01-20 -->
-
 # Relentless Agent Instructions
 
 You are an autonomous coding agent orchestrated by Relentless - a universal AI agent orchestrator.
 
 ---
 
-## Before Starting ANY Story
+## Context Already Provided
 
-**CRITICAL:** Read the feature artifacts in this order:
+The orchestrator sends you optimized context in each prompt:
 
-1. **`spec.md`** - Read FULL file to understand requirements
-2. **`plan.md`** - Read FULL file to understand technical approach
-3. **`tasks.md`** - Read ONLY the section for your current story (US-XXX)
-4. **`checklist.md`** - Review quality criteria you must satisfy
-5. **`prd.json`** - Find your story and check routing metadata
+- **Constitution** - Project principles and governance (full)
+- **spec.md** - Feature specification (full)
+- **plan.md** - Technical implementation plan (full)
+- **Current story** - Your assigned story from tasks.md with dependencies
+- **Relevant checklist** - Filtered checklist items for your story
 
-This context is essential. Do NOT skip reading these files.
+**You do NOT need to read these files separately** - they're already in your context.
 
----
+Only read files if you need additional details not provided (e.g., examining existing code patterns).
 
-## SpecKit Workflow Reference
+---
 
-Implementation is **Step 6 of 6** in the Relentless workflow:
+## ONE Story Per Iteration (CRITICAL)
 
-```
-/relentless.specify → /relentless.plan → /relentless.tasks → /relentless.convert → /relentless.analyze → /relentless.implement
-```
+**You MUST work on exactly ONE user story per iteration.**
 
-Each step generates an artifact in `relentless/features/<feature>/`:
-- `spec.md` - Feature specification (routing preference)
-- `plan.md` - Technical implementation plan (test specifications)
-- `tasks.md` - User stories with acceptance criteria
-- `checklist.md` - Quality validation checklist
-- `prd.json` - Machine-readable PRD with routing
+- Do NOT try to complete multiple stories in a single pass
+- Do NOT batch stories together for "efficiency"
+- Do NOT skip ahead to other stories after completing one
 
-**Run `/relentless.analyze` before implementing to validate artifact consistency.**
+After completing ONE story, end your turn. The orchestrator will assign the next story.
 
 ---
 
@@ -67,20 +59,18 @@ bun test
 ## Your Task (Per Iteration)
 
 1. Check you're on the correct branch from PRD `branchName`
-2. Read feature artifacts (spec.md, plan.md, your story in tasks.md)
-3. Pick the **highest priority** story where `passes: false` and dependencies met
-4. Check story routing metadata for complexity/model guidance
-5. Review checklist items tagged `[US-XXX]` for your story
-6. Review existing code to understand patterns
-7. **Write tests FIRST** (TDD is mandatory)
-8. Verify tests FAIL before implementation
-9. Implement the story to make tests PASS
-10. Run ALL quality checks (typecheck, lint, test)
-11. If ALL checks pass, commit: `feat: [Story ID] - [Story Title]`
-12. Update tasks.md: check off `- [x]` completed acceptance criteria
-13. Update checklist.md: check off `- [x]` verified items
-14. Update PRD: set `passes: true`
-15. Append progress to `progress.txt`
+2. Review the story context already provided in this prompt
+3. Review existing code to understand patterns
+4. **Write tests FIRST** (TDD is mandatory)
+5. Verify tests FAIL before implementation
+6. Implement the story to make tests PASS
+7. Run ALL quality checks (typecheck, lint, test)
+8. If ALL checks pass, commit: `feat: [Story ID] - [Story Title]`
+9. Update tasks.md: check off `- [x]` completed acceptance criteria
+10. Update checklist.md: check off `- [x]` verified items
+11. Update PRD: set `passes: true`
+12. Append progress to `progress.txt`
+13. **STOP** - Do not continue to next story
 
 ---
 
@@ -153,7 +143,7 @@ After completion, execution history is saved for cost tracking.
 
 ## Checklist Validation
 
-Before completing a story, verify against `checklist.md`:
+Before completing a story, verify against the checklist items provided:
 
 - [ ] All acceptance criteria from tasks.md satisfied
 - [ ] Tests written BEFORE implementation (TDD)
@@ -166,19 +156,6 @@ Before completing a story, verify against `checklist.md`:
 
 ---
 
-## Check for Queued Prompts
-
-Between iterations, check `.queue.txt` for user input:
-
-```bash
-# If .queue.txt exists, read and process it
-# Acknowledge in progress.txt
-# Process in FIFO order
-# Support commands: [PAUSE], [SKIP US-XXX], [ABORT]
-```
-
----
-
 ## Progress Report Format
 
 APPEND to `progress.txt` after each story (never replace):
@@ -218,7 +195,7 @@ relentless/
 │   ├── agents/       # Agent adapters (claude, amp, opencode, codex, droid, gemini)
 │   ├── config/       # Configuration schema and loading
 │   ├── prd/          # PRD parsing and validation
-│   ├── execution/    # Orchestration loop and routing
+│   ├── execution/    # Orchestration loop, routing, and context-builder
 │   ├── routing/      # Auto mode routing module
 │   └── init/         # Project initialization scaffolder
 ├── tests/            # Test files
@@ -251,29 +228,9 @@ relentless/
 
 ---
 
-## Agent-Specific Guidelines
-
-### Rate Limit Awareness
-- If you hit rate limits, note in progress.txt for future planning
-- Relentless will auto-fallback to other agents when limits hit
-
-### Model Routing Notes
-- Simple tasks: Cheaper models acceptable
-- Complex logic: Use capable models
-- Final reviews: Always use SOTA models (Opus 4.5, GPT-5.2)
-- Check prd.json routing metadata for each story
-
-### Parallel Execution
-- Tasks marked `[P]` in tasks.md can run in parallel
-- Use git worktrees for parallel work
-- Clean up worktrees after merge
-- Run integration tests after merging parallel work
-
----
-
 ## Common Mistakes to Avoid
 
-1. **Skipping spec/plan reading** - You MUST read context before coding
+1. **Doing multiple stories** - Complete exactly ONE story, then STOP
 2. **Writing code before tests** - TDD is mandatory, tests come FIRST
 3. **Ignoring lint warnings** - Zero warnings required, not just zero errors
 4. **Marking incomplete stories done** - Only mark `passes: true` when ALL criteria met
@@ -281,9 +238,6 @@ relentless/
 6. **Committing broken code** - All quality checks must pass before commit
 7. **Using Node.js APIs** - Use Bun APIs instead
 8. **Adding unnecessary dependencies** - Prefer built-in solutions
-9. **Skipping analysis** - Run `/relentless.analyze` before implementing
-10. **Ignoring checklist** - Update checklist.md after completing criteria
-11. **Not checking queue** - Always check `.queue.txt` for user input
 
 ---
 
@@ -300,21 +254,6 @@ Otherwise, end normally (next iteration continues with next story).
 
 ---
 
-## Important Reminders
-
-- Work on ONE story per iteration
-- Write tests BEFORE implementation (TDD)
-- Review existing code before implementing
-- Review checklist items for the story
-- Commit frequently with proper message format
-- Keep all quality checks passing
-- Update ALL tracking files (tasks.md, checklist.md, prd.json, progress.txt)
-- Check `.queue.txt` for mid-run input
-- Reference constitution principles in progress.txt
-- Clean up any worktrees after merging
-
----
-
 **Personalized for Relentless**
-**Generated:** 2026-01-20
+**Generated:** 2026-01-23
 **Re-generate:** /relentless.constitution

package/src/agents/claude.ts

@@ -10,9 +10,9 @@
  * Pass the model name in the `options.model` parameter.
  *
  * **Supported models:**
- * - `opus-4.5` (claude-opus-4-5-20251101) - SOTA, best for code review and architecture
- * - `sonnet-4.5` (claude-sonnet-4-5-20250929) - Balanced, good for daily coding
- * - `haiku-4.5` (claude-haiku-4-5-20251001) - Fast and cheap, good for simple tasks
+ * - `opus-4.5` (claude-opus-4-5) - SOTA, best for code review and architecture
+ * - `sonnet-4.5` (claude-sonnet-4-5) - Balanced, good for daily coding
+ * - `haiku-4.5` (claude-haiku-4-5) - Fast and cheap, good for simple tasks
  *
  * These IDs map to the full Claude model identifiers in the CLI.
  *

package/src/prd/types.ts

@@ -107,15 +107,15 @@ export type EscalationAttempt = z.infer<typeof EscalationAttemptSchema>;
  */
 export const ExecutionHistorySchema = z.object({
   /** Total number of attempts made */
-  attempts: z.number().int().min(1),
+  attempts: z.number().int().min(0).default(0),
   /** Array of escalation attempts with details */
-  escalations: z.array(EscalationAttemptSchema),
+  escalations: z.array(EscalationAttemptSchema).default([]),
   /** Total actual cost across all attempts in USD */
-  actualCost: z.number().nonnegative(),
-  /** Final harness that successfully completed the story */
-  actualHarness: HarnessNameSchema,
-  /** Final model that successfully completed the story */
-  actualModel: z.string(),
+  actualCost: z.number().nonnegative().default(0),
+  /** Final harness that successfully completed the story (optional until completion) */
+  actualHarness: HarnessNameSchema.optional(),
+  /** Final model that successfully completed the story (optional until completion) */
+  actualModel: z.string().optional(),
   /** Total input tokens used across all attempts (optional) */
   inputTokens: z.number().nonnegative().optional(),
   /** Total output tokens used across all attempts (optional) */

package/src/routing/registry.ts

@@ -93,7 +93,7 @@ export const MODEL_REGISTRY: ModelProfile[] = [
     strengths: ["code_review", "architecture", "debugging", "final_review", "complex_reasoning"],
     limitations: ["expensive", "slower_start"],
     cliFlag: "--model",
-    cliValue: "claude-opus-4-5-20251101",
+    cliValue: "claude-opus-4-5",
   },
   {
     id: "sonnet-4.5",
@@ -106,7 +106,7 @@ export const MODEL_REGISTRY: ModelProfile[] = [
     strengths: ["frontend", "refactoring", "daily_coding", "balanced"],
     limitations: [],
     cliFlag: "--model",
-    cliValue: "claude-sonnet-4-5-20250929",
+    cliValue: "claude-sonnet-4-5",
   },
   {
     id: "haiku-4.5",
@@ -121,7 +121,7 @@ export const MODEL_REGISTRY: ModelProfile[] = [
     strengths: ["prototyping", "scaffolding", "simple_tasks", "fast"],
     limitations: ["less_reasoning"],
     cliFlag: "--model",
-    cliValue: "claude-haiku-4-5-20251001",
+    cliValue: "claude-haiku-4-5",
   },
 
   // ============== Codex (OpenAI) Models ==============
@@ -196,7 +196,7 @@ export const MODEL_REGISTRY: ModelProfile[] = [
     strengths: ["architecture", "debugging", "complex_reasoning"],
     limitations: ["expensive"],
     cliFlag: "-m",
-    cliValue: "claude-opus-4-5-20251101",
+    cliValue: "claude-opus-4-5",
   },
   {
     id: "claude-sonnet-4-5-20250929",
@@ -209,7 +209,7 @@ export const MODEL_REGISTRY: ModelProfile[] = [
     strengths: ["balanced", "daily_coding"],
     limitations: [],
     cliFlag: "-m",
-    cliValue: "claude-sonnet-4-5-20250929",
+    cliValue: "claude-sonnet-4-5",
   },
   {
     id: "claude-haiku-4-5-20251001",
@@ -222,7 +222,7 @@ export const MODEL_REGISTRY: ModelProfile[] = [
     strengths: ["fast", "simple_tasks"],
     limitations: ["less_reasoning"],
     cliFlag: "-m",
-    cliValue: "claude-haiku-4-5-20251001",
+    cliValue: "claude-haiku-4-5",
   },
   {
     id: "gpt-5.2",