dd-harness 0.15.0 → 0.17.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;
@@ -693,9 +714,24 @@ function contextoDaSessao(r, worker) {
                 "(`tipo: \"politica\"` e `tipo: \"briefing\"`, uma chamada cada). Se essa " +
                 "ferramenta não estiver disponível nesta sessão, pare e diga ao usuário que " +
                 "o servidor MCP do dd-harness precisa estar conectado para isto.\n" +
+                // A politica e escrita do zero pelo agente, e este texto e o unico lugar que diz o
+                // que ela precisa conter. Sem esta linha, o roadmap chega ao contexto e nao obriga
+                // a nada: informacao passiva, que e como uma feature existe sem ser usada.
+                "   Na política, inclua uma linha sobre o roadmap: a fase **Agora** é o foco da " +
+                "sessão, e ao terminá-la o agente **propõe** concluí-la (`editar_fase` com " +
+                "`status: \"concluida\"`) — nunca conclui por conta própria, porque quem decide " +
+                "que uma fase acabou é o usuário.\n" +
                 "5. Depois de escrever os dois, sobrescreva o `CLAUDE.md` da raiz com um " +
                 "ponteiro curto para a política deste serviço — a verdade passa a morar " +
-                "aqui, e o `CLAUDE.md` local nunca mais precisa ser editado à mão." +
+                "aqui, e o `CLAUDE.md` local nunca mais precisa ser editado à mão.\n" +
+                // O momento certo de perguntar: quem acabou de descrever o projeto tem o contexto
+                // fresco para dizer por onde ele vai. Depois disso, ninguem mais pergunta — e uma
+                // feature que so se descobre lendo a lista de ferramentas nao se descobre.
+                "6. Por fim, pergunte se o trabalho deste projeto tem **fases** — algo que " +
+                "atravessa sessões, com ordem entre as partes. Se tiver, proponha as primeiras e " +
+                "crie-as com `criar_fase`; a de menor ordem vira o foco de cada sessão, e " +
+                "concluí-la a move para o changelog sozinha. Se for um projeto pequeno, diga que " +
+                "roadmap é opcional e siga sem ele — não insista." +
                 fila,
         };
     }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "dd-harness",
-  "version": "0.15.0",
+  "version": "0.17.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",