@fontdata/ai-harness 2.0.0 → 2.2.0

package/templates/hooks/sem-jargao.mjs

@@ -0,0 +1,58 @@
+// @ts-check
+// Hook PostToolUse (Edit/Write): o relatório para o cliente é escrito na linguagem de quem usa o sistema.
+import { existsSync, readFileSync } from 'node:fs';
+import { join } from 'node:path';
+import { runHook } from './lib/hook.mjs';
+import { normalize } from './lib/temas.mjs';
+import { relativeToRoot } from './lib/trabalho.mjs';
+
+/** Termos já normalizados (minúsculas, sem acento). */
+const TECHNICAL_TERMS = [
+  'endpoint',
+  'deploy',
+  'commit',
+  'merge',
+  'branch',
+  'pull request',
+  'refactor',
+  'refatoracao',
+  'stack trace',
+  'exception',
+  'excecao',
+  'null',
+  'undefined',
+  'query',
+  'sql',
+  'json',
+  'api',
+  'frontend',
+  'backend',
+  'hotfix',
+  'regex',
+  'cache',
+  'payload',
+  'schema',
+  'timeout',
+  'runtime',
+  'script',
+  'bug',
+];
+
+await runHook('sem-jargao', (input, { root }) => {
+  const rel = relativeToRoot(root, String(input.tool_input?.file_path ?? ''));
+  if (!rel || !/^docs\/trabalhos\/[^/]+\/relatorios\/CLIENTE\.md$/.test(rel)) return null;
+
+  const file = join(root, rel);
+  if (!existsSync(file)) return null;
+
+  const body = readFileSync(file, 'utf8').replace(/^\s*---\r?\n[\s\S]*?\r?\n---/, '');
+  const words = ` ${normalize(body).replace(/[^a-z0-9]+/g, ' ')} `;
+  const found = TECHNICAL_TERMS.filter((term) => words.includes(` ${term} `));
+  if (!found.length) return null;
+
+  return {
+    motivo:
+      `o relatório para o cliente usa termos técnicos: ${found.slice(0, 8).join(', ')}. ` +
+      'Reescreva na linguagem de quem usa o sistema (o que acontecia e o que muda para ele); o detalhe técnico fica no TECNICO.md.',
+  };
+});

package/templates/hooks/task-so-fecha-verde.mjs

@@ -0,0 +1,33 @@
+// @ts-check
+// Hook PostToolUse (Edit/Write): avisa quando o PLAN.md tem task concluída sem suíte verde no rastro.
+import { existsSync, readFileSync } from 'node:fs';
+import { join } from 'node:path';
+import { runHook } from './lib/hook.mjs';
+import { planTasks, relativeToRoot, workEvents } from './lib/trabalho.mjs';
+
+await runHook('task-so-fecha-verde', (input, { root }) => {
+  const rel = relativeToRoot(root, String(input.tool_input?.file_path ?? ''));
+  const match = rel ? /^docs\/trabalhos\/([^/]+)\/PLAN\.md$/.exec(rel) : null;
+  if (!rel || !match) return null;
+
+  const workId = match[1] ?? '';
+  const events = workEvents(root, workId);
+  if (!events || !existsSync(join(root, rel))) return null;
+
+  const green = new Set(events.filter((event) => event.evento === 'suite_verde').map((event) => event.task_id));
+  // Task concluída antes de o rastro existir (sem task_iniciada nem task_concluida) não é cobrada.
+  const tracked = new Set(
+    events.filter((event) => event.evento === 'task_iniciada' || event.evento === 'task_concluida').map((event) => event.task_id)
+  );
+  const missing = planTasks(readFileSync(join(root, rel), 'utf8'))
+    .filter((task) => task.status === 'concluida' && tracked.has(task.id) && !green.has(task.id))
+    .map((task) => task.id);
+  if (!missing.length) return null;
+
+  return {
+    motivo:
+      `${missing.join(', ')} está marcada como concluída em ${rel}, mas o rastro não registra suíte verde para ela. ` +
+      `Rode a suíte e registre o resultado (npx @fontdata/ai-harness evento suite_verde --trabalho ${workId} --task <id> ` +
+      `--dados '{"comando":"<comando>","total":<n>,"falhas":0}') ou volte a task para em-andamento.`,
+  };
+});