voyage/tests/validators/progress-validator.test.mjs

import { test } from 'node:test';
import { strict as assert } from 'node:assert';
import { validateProgressObject, checkResumeReadiness } from '../../lib/validators/progress-validator.mjs';

function goodProgress() {
  return {
    schema_version: '1',
    plan: '.claude/projects/x/plan.md',
    plan_type: 'plan',
    plan_version: '1.7',
    started_at: '2026-04-18T12:00:00Z',
    updated_at: '2026-04-18T13:00:00Z',
    mode: 'execute',
    total_steps: 2,
    current_step: 1,
    status: 'in_progress',
    steps: {
      '1': { status: 'completed', attempts: 1, error: null, completed_at: '2026-04-18T12:30:00Z', commit: 'abc123', manifest_audit: 'pass' },
      '2': { status: 'pending', attempts: 0, error: null, completed_at: null, commit: null, manifest_audit: null },
    },
  };
}

test('validateProgress — happy path', () => {
  const r = validateProgressObject(goodProgress());
  assert.equal(r.valid, true, JSON.stringify(r.errors));
});

test('validateProgress — wrong schema_version', () => {
  const p = goodProgress();
  p.schema_version = '2';
  const r = validateProgressObject(p);
  assert.equal(r.valid, false);
  assert.ok(r.errors.find(e => e.code === 'PROGRESS_SCHEMA_MISMATCH'));
});

test('validateProgress — missing required field', () => {
  const p = goodProgress();
  delete p.total_steps;
  const r = validateProgressObject(p);
  assert.equal(r.valid, false);
  assert.ok(r.errors.find(e => e.code === 'PROGRESS_MISSING_FIELD' && /total_steps/.test(e.message)));
});

test('validateProgress — bad status', () => {
  const p = goodProgress();
  p.status = 'maybe';
  const r = validateProgressObject(p);
  assert.equal(r.valid, false);
  assert.ok(r.errors.find(e => e.code === 'PROGRESS_BAD_STATUS'));
});

test('validateProgress — current_step out of range', () => {
  const p = goodProgress();
  p.current_step = 99;
  const r = validateProgressObject(p);
  assert.equal(r.valid, false);
  assert.ok(r.errors.find(e => e.code === 'PROGRESS_STEP_RANGE'));
});

test('validateProgress — step count mismatch is warning', () => {
  const p = goodProgress();
  p.total_steps = 5;
  const r = validateProgressObject(p);
  assert.ok(r.warnings.find(w => w.code === 'PROGRESS_STEP_COUNT_MISMATCH'));
});

test('validateProgress — iterations_remaining non-negative integer is valid', () => {
  const p = goodProgress();
  p.iterations_remaining = 7;
  const r = validateProgressObject(p);
  assert.equal(r.valid, true, JSON.stringify(r.errors));
});

test('validateProgress — iterations_remaining absent is valid (backward-compat)', () => {
  const p = goodProgress();
  delete p.iterations_remaining;
  const r = validateProgressObject(p);
  assert.equal(r.valid, true, JSON.stringify(r.errors));
});

test('validateProgress — iterations_remaining negative is invalid', () => {
  const p = goodProgress();
  p.iterations_remaining = -1;
  const r = validateProgressObject(p);
  assert.equal(r.valid, false);
  assert.ok(r.errors.find(e => e.code === 'PROGRESS_ITERATIONS_REMAINING_INVALID'));
});

test('validateProgress — iterations_remaining non-integer is invalid', () => {
  const p = goodProgress();
  p.iterations_remaining = 3.5;
  const r = validateProgressObject(p);
  assert.equal(r.valid, false);
  assert.ok(r.errors.find(e => e.code === 'PROGRESS_ITERATIONS_REMAINING_INVALID'));
});

test('checkResumeReadiness — completed run cannot resume', () => {
  const p = goodProgress();
  p.status = 'completed';
  const r = checkResumeReadiness(p);
  assert.equal(r.valid, false);
  assert.ok(r.errors.find(e => e.code === 'PROGRESS_ALREADY_DONE'));
});

test('checkResumeReadiness — in-progress is resumable', () => {
  const r = checkResumeReadiness(goodProgress());
  assert.equal(r.valid, true);
});