@daniellins/power-claude 0.16.3

package/scripts/__tests__/validate-pod-workflow.test.cjs

@@ -0,0 +1,90 @@
+#!/usr/bin/env node
+'use strict';
+/**
+ * validate-pod-workflow.test.cjs — harness de auto-verificação do validador.
+ *
+ * Roda `validate-pod-workflow.cjs` contra cada fixture e afirma o exit code
+ * esperado (0 = válido, 1 = reprovado) e, nos casos de falha, um trecho de
+ * mensagem identificável. Cobre AC2-AC8 da Story SF1.1. Exit 0/1 com relatório.
+ *
+ * Node >= 18, sem dependências externas.
+ */
+
+const path = require('node:path');
+const { spawnSync } = require('node:child_process');
+
+const REPO_ROOT = path.resolve(__dirname, '..', '..');
+const VALIDATOR = path.join(REPO_ROOT, 'scripts', 'validate-pod-workflow.cjs');
+const FIXTURES = path.join(REPO_ROOT, 'scripts', '__fixtures__', 'pod-workflow');
+
+// [fixture, expectedExit, messageSubstring, label]
+const CASES = [
+  ['valid.yaml', 0, null, 'AC8 aceita contrato válido'],
+  ['valid-veto-always-true.yaml', 0, null, 'Risco 2 aceita veto estruturado (forma), não julga semântica'],
+  ['invalid-missing-agent.yaml', 1, 'agent', 'AC2/AC4 reprova etapa sem agent'],
+  ['invalid-missing-template.yaml', 1, 'template', 'AC4 reprova etapa sem template'],
+  ['invalid-missing-veto.yaml', 1, 'veto', 'AC4 reprova etapa sem veto'],
+  ['invalid-missing-outputs.yaml', 1, 'outputs', 'AC4 reprova etapa sem outputs'],
+  ['invalid-cycle.yaml', 1, 'ciclo no DAG', 'AC3 reprova ciclo no DAG'],
+  ['invalid-template-not-on-disk.yaml', 1, 'template inexistente', 'AC5 reprova template ausente em disco'],
+  ['invalid-handoff-open.yaml', 1, 'handoff aberto', 'AC6 reprova handoff aberto'],
+  ['invalid-veto-prose.yaml', 1, 'ADR-002', 'AC7 reprova veto em prosa (ADR-002)'],
+  // Débito herdado da SF1.1 (fix-loop explícito; SPEC §B2a). Emenda da SF1.2.
+  ['valid-fix-loop.yaml', 0, null, 'SF1.2 aceita fix_cycle para etapa a montante (única aresta para trás permitida)'],
+  ['invalid-fix-loop-backedge.yaml', 1, 'ciclo no DAG', 'SF1.2 reprova fix-loop disfarçado de aresta para trás em depends_on'],
+  ['invalid-fix-loop-forward.yaml', 1, 'A MONTANTE', 'SF1.2 reprova fix_cycle apontando para frente'],
+  // SF10.1/D2 — campo opcional `knowledge:` (shape check; padrão anti_path).
+  ['valid-knowledge.yaml', 0, null, 'SF10.1 aceita knowledge: [..] bem-formado (lista de strings) + knowledge_exclude'],
+  ['invalid-knowledge-shape.yaml', 1, 'knowledge', 'SF10.1 reprova knowledge com forma errada (escalar, não lista)'],
+  // SF11.10/ADR-024 — `checkpoint`: forma + INVARIANTE do gate humano (DF-SF11.10-3). O par
+  // positivo/negativo é obrigatório: sem o negativo o invariante seria decorativo (lição
+  // SF11.2 — presença ≠ obediência). Todos os fixtures pré-existentes acima seguem passando:
+  // `checkpoint` ausente/`null`/`blocking: false` é no-op (retrocompat byte-idêntica).
+  ['valid-checkpoint-skip-modes.yaml', 0, null, 'SF11.10 aceita skip_modes quando SOBRA gate não-pulável em todo modo'],
+  ['invalid-checkpoint-all-skippable.yaml', 1, 'invariante do gate humano violado', 'SF11.10 NEGATIVO: reprova wf em que todo gate bloqueante é pulável no mesmo modo'],
+  ['invalid-checkpoint-unknown-key.yaml', 1, 'chave desconhecida', 'SF11.10 reprova chave desconhecida sob checkpoint (skew para frente)'],
+  ['invalid-checkpoint-skip-mode-desconhecido.yaml', 1, 'não é um modo de run válido', 'SF11.10 reprova skip_modes fora do conjunto fechado (o typo "YOLO" travaria a run)'],
+  // DF-SF11.10-17 (exigido pelo `*review`): o parser YAML-lite não suporta escalar de bloco e
+  // descarta o texto em silêncio — sem esta recusa, "criteria: |" passaria como string "|" e o
+  // guard contra gate mudo teria bypass pelo idioma mais natural para texto longo.
+  ['invalid-checkpoint-criteria-escalar-de-bloco.yaml', 1, 'sigilo de escalar', 'SF11.10 reprova criteria como escalar de bloco (parser descartaria o texto — gate mudo)'],
+];
+
+function run(fixture) {
+  return spawnSync(process.execPath, [VALIDATOR, path.join(FIXTURES, fixture)], {
+    encoding: 'utf8',
+    timeout: 30000,
+  });
+}
+
+function main() {
+  console.log('POWER CLAUDE — validate-pod-workflow (harness de fixtures)\n');
+  const failures = [];
+
+  for (const [fixture, expectedExit, substr, label] of CASES) {
+    const res = run(fixture);
+    const out = `${res.stdout || ''}${res.stderr || ''}`;
+    const exitOk = res.status === expectedExit;
+    const msgOk = substr === null || out.includes(substr);
+    const ok = exitOk && msgOk;
+    const detail = exitOk
+      ? (msgOk ? `exit ${res.status}` : `exit ${res.status} mas mensagem não cita "${substr}"`)
+      : `exit ${res.status}, esperado ${expectedExit}`;
+    console.log(`[${ok ? 'OK   ' : 'FALHA'}] ${label} — ${detail}`);
+    if (!ok) failures.push({ label, out });
+  }
+
+  console.log(`\n${CASES.length - failures.length}/${CASES.length} casos passaram.`);
+  if (failures.length > 0) {
+    console.error('\nHARNESS FALHOU:');
+    for (const f of failures) {
+      console.error(`  - ${f.label}`);
+      console.error(`    saída: ${f.out.trim().split('\n').join('\n           ')}`);
+    }
+    process.exit(1);
+  }
+  console.log('Harness verde.');
+  process.exit(0);
+}
+
+main();