dd-harness 0.15.0 → 0.16.0

package/dist/check.d.ts

@@ -29,6 +29,11 @@ export type ResultadoDoCheck = {
      * rename a cruzar, e a lista de ausentes continua sendo tudo o que se pode dizer.
      */
     reancoragens: Reancoragem[];
+    /**
+     * Pediram `--commit` e o cruzamento nao aconteceu — e por que. `undefined` quando
+     * aconteceu, ou quando nao se pediu commit nenhum.
+     */
+    semGit?: "sem-repositorio" | "commit-desconhecido" | "git-indisponivel";
 };
 export type ResultadoDoStatus = {
     /**

package/dist/check.js

@@ -99,6 +99,7 @@ export async function check(raiz, commit) {
             fechadas: 0,
             tocadas,
             reancoragens,
+            semGit: mudancas.semGit,
         };
     }
     const envio = await pede(`${config.api}/api/v1/deriva`, {
@@ -127,5 +128,6 @@ export async function check(raiz, commit) {
         fechadas: julgamento.fechadas ?? 0,
         tocadas,
         reancoragens,
+        semGit: mudancas.semGit,
     };
 }

package/dist/diff.d.ts

@@ -19,6 +19,16 @@ export type Rename = {
 export type MudancasDoCommit = {
     caminhos: string[];
     renames: Rename[];
+    /**
+     * Por que o cruzamento nao aconteceu. `undefined` = aconteceu (mesmo que o commit nao
+     * tenha tocado nada que uma ancora guarda).
+     *
+     * Sem isto, "o commit nao mexeu em nada indexado" e "o git nem rodou" saem identicos —
+     * uma lista vazia. Uma rodada de teste com agente-cobaia passou `--commit` com um SHA
+     * inventado, fora de um repositorio git, e recebeu exit 0 e a mesma saida de sempre: o
+     * cruzamento que ela queria exercitar simplesmente nao existiu, sem uma linha dizendo.
+     */
+    semGit?: "sem-repositorio" | "commit-desconhecido" | "git-indisponivel";
 };
 /**
  * O que um commit mudou: caminhos tocados e renames detectados.

package/dist/diff.js

@@ -17,10 +17,34 @@ export async function caminhosDoCommit(raiz, commit) {
         const { stdout } = await roda("git", ["diff-tree", "--no-commit-id", "-r", "-M", "--name-status", commit], { cwd: raiz });
         return interpretaNameStatus(stdout);
     }
-    catch {
-        return { caminhos: [], renames: [] };
+    catch (erro) {
+        // Continua sem lancar — o gancho `post-commit` nao pode falhar por causa de um aviso.
+        // O que muda e que a razao volta junto, para quem chamou poder dize-la em vez de
+        // mostrar "nenhuma mudanca" quando na verdade nada foi consultado.
+        return { caminhos: [], renames: [], semGit: classificaFalhaDoGit(erro) };
     }
 }
+/**
+ * Traduz a falha do `git diff-tree` nos tres casos que pedem respostas diferentes de quem
+ * chamou: consertar o repositorio, conferir o SHA, ou instalar o git.
+ *
+ * A leitura e do stderr porque o `git` usa o mesmo codigo de saida (128) para "not a git
+ * repository" e para "bad object" — o texto e o unico jeito de separar os dois.
+ */
+function classificaFalhaDoGit(erro) {
+    const e = erro;
+    if (e.code === "ENOENT")
+        return "git-indisponivel";
+    const stderr = e.stderr ?? "";
+    if (/not a git repository/i.test(stderr))
+        return "sem-repositorio";
+    if (/bad object|unknown revision|ambiguous argument/i.test(stderr)) {
+        return "commit-desconhecido";
+    }
+    // Falha que nao sabemos nomear: ainda e melhor avisar que o cruzamento nao aconteceu do
+    // que deixar passar como silencio.
+    return "git-indisponivel";
+}
 /**
  * Le a saida de `--name-status`: uma letra de status, TAB, e um ou dois caminhos.
  *

package/dist/index.js

@@ -553,8 +553,29 @@ async function comandoReancorar(argv) {
     console.log(`  para ${r.para}`);
     console.log("  Rode `dd-harness check --commit <sha>` para medir a base nova.");
 }
+/**
+ * Pediram `--commit` e o cruzamento com o diff nao aconteceu. Avisa ANTES do resto: sem
+ * isto a saida e identica a de um commit que nao tocou em nada indexado, e quem pediu o
+ * cruzamento nao tem como saber que ele nao existiu.
+ *
+ * Aviso, nao erro: o gancho `post-commit` termina em sucesso mesmo assim, e a medicao das
+ * ancoras (que nao depende de git) continua valendo.
+ */
+function avisaSemGit(motivo) {
+    const texto = {
+        "sem-repositorio": "esta pasta não é um repositório git — não há diff para cruzar com as âncoras.",
+        "commit-desconhecido": "o git não reconhece este commit — confira o SHA.",
+        "git-indisponivel": "não consegui rodar o git aqui.",
+    }[motivo];
+    console.log(`AVISO: ${texto}`);
+    console.log("       As âncoras foram medidas assim mesmo; só o cruzamento com o");
+    console.log("       commit ficou de fora.");
+    console.log("");
+}
 async function comandoCheck(argv) {
     const r = await check(process.cwd(), argumento(argv, "commit"));
+    if (r.semGit)
+        avisaSemGit(r.semGit);
     if (r.medidas === 0) {
         console.log("nenhuma âncora para medir.");
         return;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "dd-harness",
-  "version": "0.15.0",
+  "version": "0.16.0",
   "type": "module",
   "description": "Cliente do dd-harness: politica no inicio da sessao, e memoria por busca — nada em disco. Sem dependencia: fetch, crypto e fs sao do Node.",
   "license": "UNLICENSED",