docs(voyage): amend HANDOVER-CONTRACTS + add 5 doc-consistency pins (v5.1)

plugins/voyage/tests/lib/doc-consistency.test.mjs

@@ -551,3 +551,37 @@ test('operational files no longer reference trekrevise (v5.0.0 removal)', () =>
     );
   }
 });
+
+// --- v5.1 — phase_signals + brief_version 2.1 ---
+
+test('v5.1 — templates/trekbrief-template.md declares brief_version: 2.1', () => {
+  const t = read('templates/trekbrief-template.md');
+  assert.match(t, /^brief_version: 2\.1$/m,
+    'trekbrief-template.md must declare brief_version: 2.1 at top of frontmatter');
+});
+
+test('v5.1 — templates/trekbrief-template.md contains phase_signals: block', () => {
+  const t = read('templates/trekbrief-template.md');
+  assert.match(t, /^phase_signals:$/m,
+    'trekbrief-template.md must contain a phase_signals: block in frontmatter');
+});
+
+test('v5.1 — HANDOVER-CONTRACTS.md schema row includes phase_signals + phase_signals_partial', () => {
+  const t = read('docs/HANDOVER-CONTRACTS.md');
+  assert.ok(t.includes('| `phase_signals` |'),
+    'HANDOVER-CONTRACTS must add a phase_signals row to the Handover 1 schema table');
+  assert.ok(t.includes('| `phase_signals_partial` |'),
+    'HANDOVER-CONTRACTS must add a phase_signals_partial row to the Handover 1 schema table');
+});
+
+test('v5.1 — voyage CLAUDE.md mentions phase_signals', () => {
+  const t = read('CLAUDE.md');
+  assert.ok(t.includes('phase_signals'),
+    'voyage CLAUDE.md must document phase_signals (v5.1)');
+});
+
+test('v5.1 — voyage README.md mentions phase_signals', () => {
+  const t = read('README.md');
+  assert.ok(t.includes('phase_signals'),
+    'voyage README.md must mention phase_signals (v5.1 "What\'s new" bullet)');
+});