// tests/lib/gates-flag-coverage.test.mjs
// Step 11 (plan-v2) — pin that all four pipeline commands document the
// --gates autonomy-control flag and consume the autonomy-gate state
// machine via the lib/util/autonomy-gate.mjs CLI shim.

import { test } from 'node:test';
import { strict as assert } from 'node:assert';
import { readFileSync } from 'node:fs';
import { dirname, join } from 'node:path';
import { fileURLToPath } from 'node:url';

const HERE = dirname(fileURLToPath(import.meta.url));
const ROOT = join(HERE, '..', '..');

function read(rel) { return readFileSync(join(ROOT, rel), 'utf-8'); }

const COMMANDS = [
  'commands/trekbrief.md',
  'commands/trekresearch.md',
  'commands/trekplan.md',
  'commands/trekexecute.md',
];

for (const cmdPath of COMMANDS) {
  test(`${cmdPath} documents the --gates flag`, () => {
    const text = read(cmdPath);
    assert.ok(
      text.includes('--gates'),
      `${cmdPath} should document the --gates autonomy-control flag (Step 11)`,
    );
  });

  test(`${cmdPath} wires the autonomy-gate.mjs CLI shim`, () => {
    const text = read(cmdPath);
    assert.ok(
      text.includes('autonomy-gate.mjs'),
      `${cmdPath} should reference lib/util/autonomy-gate.mjs as the state-machine implementation`,
    );
  });
}

test('commands/trekexecute.md mentions MAIN_MERGE_GATE', () => {
  const text = read('commands/trekexecute.md');
  assert.ok(
    text.includes('MAIN_MERGE_GATE'),
    'commands/trekexecute.md should name MAIN_MERGE_GATE — the only boundary that always pauses regardless of --gates',
  );
});