@polymorphism-tech/morph-spec 9.2.0 → 9.3.0

package/src/utils/agents-installer.js

@@ -2,6 +2,7 @@ import { readFileSync, existsSync, readdirSync } from 'node:fs';
 import { join } from 'path';
 import { shouldInstall } from '../lib/stack-filter.js';
 import { realEffects } from '../lib/installers/effects.js';
+import { REVIEW_ROLES, VERDICT_TOKEN, REVIEWED_SHA_TOKEN, VERDICTS } from '../lib/review-reports.js';
 
 export const DEFAULT_AGENT_TOOLS = 'Read, Write, Edit, Bash, Glob, Grep';
 
@@ -300,6 +301,8 @@ export const DISPATCH_CONTRACT = [
     '`git checkout --`). A prova de que o teste morde é do verificador (Gate 3).',
   '9. ESCRITA: código e teste do projeto só por Write/Edit, nunca pelo Bash — heredoc, redirecionamento, `sed -i` ou script python/node que grava (`cat > X.cs <<EOF`, `sed -i … X.cs`): ' +
     'os guards de escrita só enxergam Write/Edit.',
+  '10. BLOQUEIO: decisão que não é sua (requisito contra o plano ou um ADR, escolha deixada ao humano) → `BLOQUEADO` na 1ª linha, ' +
+    'com a pergunta e as opções. Dificuldade técnica não é bloqueio.',
   '',
   'Formato do relatório (o `report-check` lê estas marcas):',
   '',
@@ -317,6 +320,25 @@ export const DISPATCH_CONTRACT = [
     'Problemas e como foram resolvidos vão em prosa depois.',
 ];
 
+export const REVIEW_REPORT_CONTRACT = [
+  '## Relatório do Gate 3',
+  '',
+  'Grave o relatório que o dispatch nomeia ANTES de encerrar — o arquivo é o retorno, não a mensagem final. ' +
+    'Se ele já existir quando você começar, é resíduo de outra rodada: não o leia antes de escrever o seu (ancoragem no veredito alheio), ' +
+    'e não leia os relatórios dos outros papéis.',
+  '',
+  `Primeira linha \`${VERDICT_TOKEN} ${VERDICTS.join('|')}\`, depois \`${REVIEWED_SHA_TOKEN} {sha}\`, ` +
+    'tabela `## Bloqueadores` (`| id | tipo | onde | evidência |`; vazia = `Nenhum.`) e `## Notas`. ' +
+    'Bloqueador só com evidência e tipo; o resto é nota, e nota nunca pede rodada nova.',
+  '',
+  'Numa confirmação (o orquestrador te retoma depois da correção, com o `sha` novo) acrescente ao fim uma seção nova com ' +
+    `\`${VERDICT_TOKEN}\` e \`${REVIEWED_SHA_TOKEN} {sha novo}\`: se você abriu bloqueadores, julgue só eles; ` +
+    'se não abriu, julgue só o delta `{sha anterior}..{sha novo}` — o que a correção abriu. ' +
+    'O relatório é append-only: vale o último veredito e, na `## Checks`, a última linha de cada Cn.',
+  '',
+  'Um comando por chamada de Bash, sem encadear (`;`, `&&`, pipe): o composto é negado e custa a rodada.',
+];
+
 function buildBody(agent, maxTurns) {
   const lines = [
     `# ${agent.title ?? agent.id}`,
@@ -374,6 +396,7 @@ function buildBody(agent, maxTurns) {
         'O entregável é o arquivo de relatório que o dispatch nomeia; sem arquivo nomeado, é a sua mensagem final (no scout, o mapa).',
       '',
     );
+    if (Object.hasOwn(REVIEW_ROLES, agent.id)) lines.push(...REVIEW_REPORT_CONTRACT, '');
   }
 
   lines.push(