@weldr/runr 0.7.2 → 0.7.4

package/CHANGELOG.md

@@ -7,6 +7,45 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## [Unreleased]
 
+## [0.7.3] - 2026-01-08
+
+**Documentation Consistency** - Complete rebrand cleanup.
+
+### Fixed
+
+- Complete documentation rebrand from `agent` → `runr` commands
+- Updated all path references from `.agent/` → `.runr/`
+- Fixed worktree path references (`.agent-worktrees/` → `.runr-worktrees/`)
+- Updated config file references (`agent.config.json` → `runr.config.json`)
+- Rebranded "Agent Framework" → "Runr" throughout docs
+
+### Added
+
+- Documentation for v0.7.x features in MIGRATION.md (modes, hooks, demo)
+- Missing CLI commands in docs/cli.md (`--demo`, `continue`, `meta`, `watch`)
+- Documentation audit document (docs/DOCS_AUDIT.md)
+
+## [0.7.2] - 2026-01-07
+
+**Rails-energy UX refresh** - 2-minute try-it flow.
+
+### Added
+
+- `runr init --demo` flag for self-contained TypeScript demo project
+- Demo includes 3 graduated tasks (success, fix-loop, scope-violation)
+- Built-in verification with TypeScript and Vitest
+
+## [0.7.1] - 2026-01-06
+
+**Sprint Complete** - Git hooks and mode-aware commit checking.
+
+### Added
+
+- Git hooks mechanism with `runr hooks install`
+- Mode-aware commit check behavior (flow vs ledger)
+- Orchestration receipt (manager dashboard)
+- Stop footer with clear next steps
+
 ## [0.7.0] - 2026-01-06
 
 **Hybrid Workflow Foundation** - Productivity + Auditability together.

package/dist/cli.js

@@ -47,6 +47,13 @@ import { computeBrain } from './ux/brain.js';
 import { formatFrontDoor, formatJson as formatBrainJson } from './ux/render.js';
 import { recordFrontDoor } from './ux/telemetry.js';
 import fs from 'node:fs';
+import path from 'node:path';
+import { fileURLToPath } from 'node:url';
+// Read version from package.json at module load time
+const __dirname = path.dirname(fileURLToPath(import.meta.url));
+const packageJsonPath = path.resolve(__dirname, '../package.json');
+const packageJson = JSON.parse(fs.readFileSync(packageJsonPath, 'utf-8'));
+const CLI_VERSION = packageJson.version;
 const program = new Command();
 // Check if invoked as deprecated 'agent' command
 const invokedAs = process.argv[1]?.split('/').pop() || 'runr';
@@ -69,7 +76,7 @@ Advanced:
 program
     .name('runr')
     .description('Autopilot for agent tasks')
-    .version('0.7.1');
+    .version(CLI_VERSION);
 // ============================================================================
 // CORE COMMANDS (the 5 commands everyone needs)
 // ============================================================================

package/dist/commands/init.js

@@ -386,14 +386,18 @@ async function generateDemoProject(demoDir) {
  */
 export function add(a: number, b: number): number { return a + b; }
 export function subtract(a: number, b: number): number { return a - b; }
+export function divide(a: number, b: number): number { return a / b; }
 // TODO: implement multiply
 `);
     fs.writeFileSync(path.join(demoDir, 'tests', 'math.test.ts'), `import { describe, it, expect } from 'vitest';
-import { add, subtract } from '../src/math.js';
+import { add, subtract, divide } from '../src/math.js';
 
 describe('math', () => {
   it('adds two numbers', () => { expect(add(2, 3)).toBe(5); });
   it('subtracts two numbers', () => { expect(subtract(5, 3)).toBe(2); });
+  // INTENTIONAL BUG: expects 999 but divide(10, 2) returns 5
+  // Task 01 will fix this by changing 999 to 5
+  it('divides two numbers', () => { expect(divide(10, 2)).toBe(999); });
 });
 `);
     const runrConfig = {
@@ -423,20 +427,27 @@ Add a multiply function to src/math.ts and add a test for it.
 - npm run typecheck passes
 - npm test passes
 `);
-    fs.writeFileSync(path.join(demoDir, '.runr', 'tasks', '01-intentional-fail.md'), `# Add divide function with edge case
+    fs.writeFileSync(path.join(demoDir, '.runr', 'tasks', '01-fix-failing-test.md'), `# Fix the failing divide test
 
 ## Goal
-Add a divide function with tests including edge cases.
+The divide test is currently failing. Fix it.
+
+## Context
+Run \`npm test\` to see the failure. The test expects the wrong value.
 
 ## Requirements
-- Add \`divide(a: number, b: number): number\` to src/math.ts
-- Add tests including divide(10, 2) === 5 and divide(10, 0) === Infinity
+- Fix the failing test in tests/math.test.ts
+- The divide(10, 2) test should expect 5, not 999
 
 ## Success Criteria
 - npm run typecheck passes
 - npm test passes
+
+## Note
+This task demonstrates the autofix flow. When verification fails,
+run \`runr\` to see safe commands, then \`runr continue\` to auto-fix.
 `);
-    fs.writeFileSync(path.join(demoDir, '.runr', 'tasks', '02-scope-violation.md'), `# Update README with project description
+    fs.writeFileSync(path.join(demoDir, '.runr', 'tasks', '02-scope-violation.md'), `# Update README (will be blocked)
 
 ## Goal
 Update README.md to describe this math library.
@@ -448,63 +459,93 @@ Update README.md to describe this math library.
 ## Success Criteria
 - README.md contains function documentation
 
-## Note
-This task will trigger a scope violation because README.md is in the denylist.
+## Expected Behavior
+This task WILL be blocked by the scope guard.
+README.md is in the denylist (see .runr/runr.config.json).
+
+This demonstrates Runr's safety guardrails working correctly.
+Run \`runr report latest\` to see the guard violation details.
 `);
     fs.writeFileSync(path.join(demoDir, 'README.md'), `# Runr Demo
 
 Try Runr in 2 minutes.
 
-## Step 1: Install
+## Setup
 
 \`\`\`bash
 npm install
 \`\`\`
 
-## Step 2: Run the tasks
+---
 
-### Task 00: Success (quick win)
+## Task 1: Success (the happy path)
 
 \`\`\`bash
 runr run --task .runr/tasks/00-success.md
 \`\`\`
 
-**Expected:** Completes cleanly. The agent adds a multiply function and test.
+**What happens:** Agent adds a multiply function, tests pass, checkpoint created.
+
+\`\`\`bash
+runr report latest   # See the run details
+\`\`\`
+
+---
+
+## Task 2: Autofix (the "wow" moment)
+
+This task has a **failing test** (intentional). Watch Runr detect it and offer safe commands.
 
 \`\`\`bash
-runr report latest   # see what happened
+runr run --task .runr/tasks/01-fix-failing-test.md
 \`\`\`
 
-### Task 01: Failure + Recovery
+**What happens:** Verification fails (npm test fails). Run stops.
 
 \`\`\`bash
-runr run --task .runr/tasks/01-intentional-fail.md
+runr                 # Shows STOPPED + 3 next actions
 \`\`\`
 
-**Expected:** May stop (verification failed or review loop). This is intentional.
+You'll see safe commands like \`npm test\`. Now auto-fix:
 
 \`\`\`bash
-runr                 # shows STOPPED + 3 next actions
-runr continue        # attempt auto-fix
-runr report latest
+runr continue        # Runs safe commands, then resumes
 \`\`\`
 
-### Task 02: Scope Guard
+\`\`\`bash
+runr report latest   # See what was fixed
+\`\`\`
+
+---
+
+## Task 3: Guard (safety demo)
+
+This task tries to modify README.md, which is in the denylist.
 
 \`\`\`bash
 runr run --task .runr/tasks/02-scope-violation.md
 \`\`\`
 
-**Expected:** STOPPED (scope guard). README.md is in the denylist.
+**What happens:** STOPPED immediately. Scope guard blocks the change.
+
+\`\`\`bash
+runr                 # Shows BLOCKED headline + manual recipe
+runr report latest   # See the guard violation details
+\`\`\`
+
+This is the safety layer working correctly. No \`--force\` can bypass scope.
+
+---
+
+## The Point
 
-This demonstrates the safety guardrails.
+Runr stops with receipts and 3 actions you can trust:
 
-## The point
+1. **continue** — run safe commands, then resume
+2. **report** — inspect the run: diffs, logs, timeline
+3. **intervene** — record manual fixes for provenance
 
-Runr stops with receipts and 3 next actions you can trust:
-- **continue** — auto-fix what's safe, then resume
-- **report** — open the run receipt: diffs + logs + timeline
-- **intervene** — record manual fixes
+Every stop has a headline. Every headline maps to a fix.
 `);
     fs.writeFileSync(path.join(demoDir, '.gitignore'), 'node_modules/\ndist/\n.runr/runs/\n');
 }

package/dist/commands/version.js

@@ -59,7 +59,7 @@ export function getVersionInfo() {
  */
 function formatVersion(info) {
     const lines = [];
-    lines.push(`Agent Runner v${info.agent_version}`);
+    lines.push(`Runr v${info.agent_version}`);
     lines.push(`  Artifact Schema: v${info.artifact_schema_version}`);
     lines.push(`  Node: ${info.node}`);
     lines.push(`  Platform: ${info.platform}`);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@weldr/runr",
-  "version": "0.7.2",
+  "version": "0.7.4",
   "description": "Phase-gated orchestration for agent tasks",
   "type": "module",
   "bin": {