@fontdata/ai-harness 3.3.0 → 3.3.1

package/.claude-plugin/plugin.json

@@ -1,8 +1,8 @@
 {
   "name": "fontdata",
-  "version": "3.3.0",
+  "version": "3.3.1",
   "mcpServers": {
-    "banco_dados": { "command": "npx", "args": ["-y", "@fontdata/ai-harness@3.3.0", "banco-dados-mcp"] }
+    "banco_dados": { "command": "npx", "args": ["-y", "@fontdata/ai-harness@3.3.1", "banco-dados-mcp"] }
   },
   "description": "Harness de engenharia com IA da Fontdata para Claude Code",
   "author": { "name": "Fontdata" },

package/dist/doctor/checks.js

@@ -325,9 +325,17 @@ function checkStaleDraftPlans(root, now) {
     }
     return findings;
 }
+/** Script SQL entregável do trabalho: `<id>.sql` ou `<id>-<sufixo>.sql`, só na raiz da pasta. */
+function isWorkScript(rel, work) {
+    if (rel === `${work}.sql`)
+        return true;
+    if (!rel.startsWith(`${work}-`) || !rel.endsWith('.sql'))
+        return false;
+    return /^[a-z0-9]+(-[a-z0-9]+)*$/.test(rel.slice(work.length + 1, -'.sql'.length));
+}
 /** Nome que só difere de um artefato pela caixa já é apontado por `contrato-nome-fora-do-padrao`. */
-function isOutsideContract(rel) {
-    if (rel in ARTIFACT_TYPES || rel.startsWith('anexos/'))
+function isOutsideContract(rel, work) {
+    if (rel in ARTIFACT_TYPES || rel.startsWith('anexos/') || isWorkScript(rel, work))
         return false;
     if (rel.split('/').at(-1)?.startsWith('.'))
         return false;
@@ -335,15 +343,18 @@ function isOutsideContract(rel) {
 }
 function checkFilesOutsideContract(root) {
     return activeWorkFolders(root).flatMap((work) => {
-        const extras = listWorkFiles(join(root, WORKS_DIR, work)).filter(isOutsideContract);
+        const extras = listWorkFiles(join(root, WORKS_DIR, work)).filter((rel) => isOutsideContract(rel, work));
         if (!extras.length)
             return [];
+        const renomear = extras.some((rel) => rel.toLowerCase().endsWith('.sql'))
+            ? ` Se é o script SQL do trabalho, renomeie para ${work}.sql (ou ${work}-<sufixo>.sql) na raiz da pasta.`
+            : '';
         return [
             {
                 id: 'arquivo-fora-do-contrato',
                 severidade: 'aviso',
                 mensagem: `docs/trabalhos/${work}/ tem arquivo(s) fora do contrato de artefatos: ${extras.join(', ')}.`,
-                correcao: `Se é relatório, mova o conteúdo para relatorios/TECNICO.md ou o arquivo para anexos/. Contrato: ${CONTRACT_URL}`,
+                correcao: `Se é relatório, mova o conteúdo para relatorios/TECNICO.md ou o arquivo para anexos/.${renomear} Contrato: ${CONTRACT_URL}`,
             },
         ];
     });

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@fontdata/ai-harness",
-  "version": "3.3.0",
+  "version": "3.3.1",
   "description": "Harness de engenharia com IA da Fontdata para Claude Code: roda os slash commands direto na pasta do projeto via npx, sem instalar nada — ou instala-os em .claude/commands.",
   "type": "module",
   "bin": {

package/templates/CLAUDE.md

@@ -27,6 +27,7 @@ Comece por `/harness`, que conduz o setup em etapas.
 | `docs/trabalhos/<id>/DECISOES.md` | Decisões tomadas no planejamento e na execução |
 | `docs/trabalhos/<id>/BLOQUEIOS.md` | Dúvidas que pararam uma task |
 | `docs/trabalhos/<id>/relatorios/TECNICO.md` e `relatorios/CLIENTE.md` | Relatório para engenharia e para cliente e suporte (sem jargão) |
+| `docs/trabalhos/<id>/<id>.sql` | Script SQL entregável do trabalho, opcional (`<id>-<sufixo>.sql` se houver mais de um); apoio vai em `anexos/` |
 | `docs/eventos/<id>.jsonl` | Rastro de eventos (não versionado por padrão) |
 | `.ai-harness/` | Lock da instalação e configuração dos hooks (versionar) |
 

package/templates/rules/comentarios.md

@@ -47,6 +47,7 @@ Se o porquê não cabe em 3 linhas, **ele não pertence ao código**.
 | Task / fase / plano / spec | `PLAN.md` e `SPEC.md` do trabalho em `docs/trabalhos/<id>/` | comentário |
 | Diagnóstico e correção de um defeito | trabalho do tipo `bug` em `docs/trabalhos/<id>/` | comentário |
 | Investigação, medição, auditoria, paridade, comparação | `relatorios/TECNICO.md` do trabalho em `docs/trabalhos/<id>/` | comentário |
+| Script SQL entregável do trabalho (DDL/DML) | raiz do trabalho, `docs/trabalhos/<id>/<id>.sql` | comentário |
 | Documento de apoio do trabalho (imagem, planilha, export, contrato de API) | `anexos/` do trabalho em `docs/trabalhos/<id>/` | comentário |
 | Achado de review | resposta do review, commit | comentário |
 | Decisão de arquitetura | `SPEC.md` | comentário |
@@ -59,7 +60,8 @@ auditoria, paridade com legado, medição, comparação, levantamento, handoff o
 
 Convenção: uma pasta por trabalho, `docs/trabalhos/<yyyy-mm-dd>-<slug>/`. Relatório não ganha nome livre em
 `relatorios/`: o conteúdo vai para `relatorios/TECNICO.md` e o arquivo de apoio para `anexos/`, senão o `doctor`
-avisa `arquivo-fora-do-contrato`.
+avisa `arquivo-fora-do-contrato`. O script SQL do trabalho é entregável, não apoio: fica na raiz como `<id>.sql`
+(ou `<id>-<sufixo>.sql`).
 
 ## Antes e depois