voyage/tests/lib/critic-severity-rules.test.mjs

// tests/lib/critic-severity-rules.test.mjs
// The two plan reviewers (plan-critic, scope-guardian) must state rule B word for
// word as lib/review/critic-diff.mjs exports it, keep the 2026-10-08 rule that a
// test which cannot fail on a wrong implementation is major, tag security
// findings with Voyage's own security keys (never the engines' key, decision
// 167, E 2.3), and carry the round-2 fields
// (`previous`, `line_end`, `lowered_from`, `caught_by`) in their json template.
// The name is the brief's.

import { test } from 'node:test';
import { strict as assert } from 'node:assert';
import { readFileSync } from 'node:fs';
import { join, dirname } from 'node:path';
import { fileURLToPath } from 'node:url';
import { RULE_B } from '../../lib/review/critic-diff.mjs';
import { RULE_CATALOGUE } from '../../lib/review/rule-catalogue.mjs';

const ROOT = join(dirname(fileURLToPath(import.meta.url)), '..', '..');
const read = rel => readFileSync(join(ROOT, rel), 'utf-8');
const norm = s => s.replace(/\s+/g, ' ');

const AGENTS = ['agents/plan-critic.md', 'agents/scope-guardian.md'];

// The one json template an agent file carries: the fenced block after
// "Machine-readable findings block".
function jsonTemplate(text, rel) {
  const head = text.indexOf('Machine-readable findings block');
  assert.ok(head >= 0, `${rel}: machine-readable findings block heading missing`);
  const m = /```json\n([\s\S]*?)\n```/.exec(text.slice(head));
  assert.ok(m, `${rel}: no fenced json template after the heading`);
  return JSON.parse(m[1]);
}

// The engines' key (/security-review, Claude Security): never the critic's (decision 167).
const ENGINES_KEY = 'SECURITY_REVIEW_VULNERABILITY';

test('the catalogue has exactly three security keys: SECURITY_INJECTION, SECURITY_REVIEW_VULNERABILITY and SECURITY_RISK', () => {
  const keys = RULE_CATALOGUE.filter(r => r.category === 'security').map(r => r.rule_key).sort();
  assert.deepEqual(keys, ['SECURITY_INJECTION', 'SECURITY_REVIEW_VULNERABILITY', 'SECURITY_RISK']);
});

for (const rel of AGENTS) {
  test(`${rel}: states rule B verbatim (never a blocker, never a security finding)`, () => {
    const t = norm(read(rel));
    assert.ok(t.includes(norm(RULE_B)), `${rel} must contain the RULE_B sentence from critic-diff.mjs`);
    assert.ok(t.includes('never a blocker, never a security finding'));
    assert.ok(
      t.includes('The 2026-10-08 rule still holds for rule B: a test that cannot fail on a wrong implementation catches nothing, so the finding stays major.'),
      `${rel} must say the 2026-10-08 rule still holds for rule B`,
    );
    assert.ok(t.includes('Give `lowered_from` and `caught_by` when you lower a finding this way.'));
    assert.ok(!/\brule A\b/i.test(t), `${rel} must not state rule A (plan Design § Gotchas)`);
  });

  test(`${rel}: keeps the 2026-10-08 rule (cannot fail on a wrong implementation is major; catalogue tier)`, () => {
    const raw = read(rel);
    assert.match(raw, /cannot fail on a wrong\s+implementation[\s\S]{0,200}\*\*major\*\*/);
    assert.ok(norm(raw).includes("Whenever a finding is the same class as a catalogue rule, use that rule's tier"));
  });

  test(`${rel}: a security finding uses the catalogue's security rule_key`, () => {
    const t = norm(read(rel));
    const keys = RULE_CATALOGUE.filter(r => r.category === 'security' && r.rule_key !== ENGINES_KEY).map(r => r.rule_key);
    for (const k of keys) assert.ok(t.includes(`\`${k}\``), `${rel} must name \`${k}\``);
    assert.ok(t.includes("A security finding uses the catalogue's security `rule_key`"));
  });

  test(`${rel}: the critic never names the engines' key (decision 167)`, () => {
    assert.ok(!read(rel).includes(ENGINES_KEY), `${rel} must not name ${ENGINES_KEY}: it is the engines' key only`);
  });

  test(`${rel}: [STP] rule_key names the class, never the instance (the stop rule's class, decision 217)`, () => {
    const t = norm(read(rel));
    assert.ok(t.includes('`rule_key` names the class, never the instance'), `${rel} must say rule_key names the class, never the instance`);
  });

  test(`${rel}: round 2+ lists every previous finding by id and cites the exact line`, () => {
    const t = norm(read(rel));
    assert.ok(t.includes('From round 2 the prompt gives you the diff since the last reviewed text'), `${rel}: round-2 diff sentence missing`);
    assert.ok(t.includes('List every previous finding by id in `previous`, with `resolved: true` only when the plan now fixes it.'));
    assert.ok(t.includes('Cite the exact line, with `line_end` for a range.'));
  });

  test(`${rel}: the json template carries previous, line_end, lowered_from and caught_by beside the old fields`, () => {
    const tpl = jsonTemplate(read(rel), rel);
    assert.equal(typeof tpl.agent, 'string');
    assert.ok(Array.isArray(tpl.findings) && tpl.findings.length >= 1, 'findings array with one example');
    assert.ok(Array.isArray(tpl.previous) && tpl.previous.length >= 1, 'previous array with one example');
    assert.ok('id' in tpl.previous[0] && 'resolved' in tpl.previous[0], 'previous entries carry id and resolved');
    const f = tpl.findings[0];
    for (const k of ['file', 'line', 'rule_key', 'severity', 'text', 'line_end', 'lowered_from', 'caught_by']) {
      assert.ok(k in f, `finding template lacks "${k}"`);
    }
  });
}

test('plan-critic no longer tells the critic to judge only the plan in front of it', () => {
  assert.ok(
    !norm(read('agents/plan-critic.md')).includes('judge the plan in front of you'),
    'the round-2 paragraph replaces "judge the plan in front of you"',
  );
});