dd-harness 0.6.0 → 0.8.0

package/dist/brain.d.ts

@@ -37,6 +37,8 @@ export type Brain = {
     };
     politica?: string | null;
     briefing?: string | null;
+    /** Politica E briefing tem conteudo real? Calculado no servico, nunca inferido aqui. */
+    briefado?: boolean;
     pastas: {
         slug: string;
         definicao: string;

package/dist/curar.d.ts

@@ -25,6 +25,12 @@ export type MemoriaDoServico = {
         valor: string;
         sha: string | null;
     }[];
+    /**
+     * Os OUTROS projetos (slugs do mesmo tenant) que esta memoria tambem alcanca. Sem este
+     * campo no round-trip ler->editar->enviar, o vinculo transversal se perdia em silencio
+     * — achado numa rodada de teste real.
+     */
+    projetos?: string[];
 };
 /**
  * A memoria inteira, no markdown que `gravar` e `editar` consomem.

package/dist/curar.js

@@ -30,6 +30,9 @@ export function comoMarkdown(m) {
         `description: ${m.resumo}`,
         `pasta: ${m.pasta}`,
         ...(m.revisar_ate ? [`revisar-ate: ${m.revisar_ate.slice(0, 10)}`] : []),
+        // So aparece quando ha vinculo — omitir e "so este projeto", igual a `gravar` sem
+        // `projetos:`. Formato inline (`a, b`), que e o que `interpreta` ja sabe ler.
+        ...(m.projetos?.length ? [`projetos: ${m.projetos.join(", ")}`] : []),
         "---",
         "",
         m.corpo.trim(),
@@ -62,6 +65,10 @@ export async function edita(raiz, caminho) {
             invisibilidade: memoria.invisibilidade,
             externalidade: memoria.externalidade,
             ancoras: memoria.ancoras,
+            // So manda quando o arquivo TINHA a chave `projetos:` — omitida, o servico
+            // mantem os vinculos como estao. `le` sempre escreve a chave quando ha vinculo,
+            // entao editar o arquivo que veio de `le` preserva o round-trip.
+            ...(memoria.tambemEmInformado ? { projetos: memoria.tambemEm } : {}),
         }),
     });
     if (!resposta.ok)

package/dist/gravar.d.ts

@@ -16,6 +16,14 @@ export type MemoriaLida = {
     externalidade: string;
     ancoras: string[];
     tambemEm: string[];
+    /**
+     * O frontmatter TINHA a chave `projetos:`? `gravar` nao usa isto (chave ausente e
+     * `projetos: ` vazio significam a mesma coisa ali: "so este projeto"). `editar` usa —
+     * la a ausencia da chave precisa significar "nao estou informando vinculos", diferente
+     * de uma lista vazia explicita, senao editar sem tocar em `projetos:` apagaria o
+     * vinculo transversal por omissao.
+     */
+    tambemEmInformado: boolean;
 };
 export declare function interpreta(texto: string): MemoriaLida;
 export declare function grava(raiz: string, caminho: string): Promise<{

package/dist/gravar.js

@@ -151,6 +151,7 @@ export function interpreta(texto) {
             .split(",")
             .map((s) => s.trim())
             .filter(Boolean),
+        tambemEmInformado: campos.has("projetos"),
     };
 }
 export async function grava(raiz, caminho) {

package/dist/index.js

@@ -271,7 +271,12 @@ async function comandoCheck(argv) {
         console.log(`${r.fechadas} deriva(s) fechada(s): o alvo voltou a bater com a linha de base.`);
     }
     if (!r.ausentes.length && r.novas === 0 && r.jaAbertas === 0 && r.fechadas === 0) {
-        console.log("nenhuma deriva: o mundo ainda bate com o que as memórias dizem.");
+        // "Nenhuma deriva" e nao "o mundo bate com o que a memoria diz": isto mede se a
+        // ANCORA (localizacao/conteudo) mudou, nunca se o COMPORTAMENTO ainda corresponde ao
+        // texto. Dois agentes-cobaia independentes leram a frase antiga como garantia
+        // semantica que o mecanismo nao da — trocar quebra e proposital comportamento
+        // continuar identico ao de antes.
+        console.log("nenhuma âncora mudou de lugar ou de conteúdo desde a última medição.");
     }
     // O cruzamento com o diff e outra coisa que deriva: e "voce acabou de mexer no que
     // esta memoria guarda". Vale mesmo quando a memoria continua valendo — e o revisor
@@ -311,7 +316,9 @@ async function comandoPolitica(argv) {
         return;
     }
     if (r.estado === "sem-politica") {
-        console.error("Este projeto ainda não tem política — nunca foi briefado. Rode `/briefar`.");
+        console.error("Este projeto ainda não tem política e/ou briefing — os dois são obrigatórios. " +
+            "Rode uma sessão com `--hook` (ou converse com o agente): ele vai conduzir o " +
+            "briefing agora e escrever os dois.");
         process.exitCode = 3;
         return;
     }
@@ -340,9 +347,23 @@ function contextoDaSessao(r, worker) {
     if (r.estado === "sem-politica") {
         return {
             ...base,
-            additionalContext: "AVISO DO DD-HARNESS: este projeto existe no serviço mas **nunca foi briefado** " +
-                "— não há política.\n\nIsto não é uma falha: é um projeto novo. Antes de " +
-                "implementar qualquer coisa, diga isso ao usuário e proponha rodar `/briefar`." +
+            additionalContext: "AVISO DO DD-HARNESS: este projeto existe no serviço mas política e/ou " +
+                "briefing **estão faltando** — os dois são obrigatórios.\n\n" +
+                "Isto não é uma falha: é um projeto novo. Antes de implementar qualquer " +
+                "coisa, conduza o briefing agora, nesta sessão:\n\n" +
+                "1. Se houver um `CLAUDE.md` na raiz deste repositório, leia-o primeiro — o " +
+                "que ele já diz é ponto de partida, não é para ser ignorado.\n" +
+                "2. Pergunte ao usuário o que o código e o `CLAUDE.md` não revelarem: " +
+                "objetivo do projeto, stack principal, restrições e convenções.\n" +
+                "3. Mostre o rascunho da política e do briefing e espere a confirmação " +
+                "explícita do usuário antes de escrever.\n" +
+                "4. Escreva os dois com a ferramenta MCP `escrever_artefato` " +
+                "(`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" +
+                "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." +
                 fila,
         };
     }

package/dist/politica.d.ts

@@ -5,9 +5,10 @@
  * nenhuma sessao abre sem protocolo. Por isso o retorno separa TRES situacoes que um
  * "deu erro" colapsaria — e cada uma pede uma reacao diferente de quem chamou:
  *
- * - `ok`: a politica existe e veio. Segue a sessao.
- * - `sem-politica`: o projeto existe e nunca foi briefado. NAO e falha: a saida e rodar o
- *   briefing. Tratar como erro faria todo projeto novo parecer quebrado.
+ * - `ok`: politica E briefing existem. Segue a sessao.
+ * - `sem-politica`: falta politica OU briefing (os dois sao obrigatorios). NAO e falha: a
+ *   saida e conduzir o briefing agora, na sessao. Tratar como erro faria todo projeto
+ *   novo parecer quebrado.
  * - `inalcancavel`: rede, timeout, 5xx, credencial, projeto inexistente. A politica pode
  *   existir e nao chegou — e ai a sessao precisa PARAR, porque seguir sem ela e
  *   exatamente a falha que este projeto combate.

package/dist/politica.js

@@ -24,9 +24,13 @@ export async function buscaPolitica(raiz) {
         const payload = (await resposta.json());
         const conteudo = payload.politica?.trim();
         const esperandoIndexacao = payload.esperando_indexacao ?? 0;
-        // Vazio e nulo sao a mesma coisa aqui, e os dois significam "nunca foi escrita".
-        if (!conteudo)
+        // `briefado` e do SERVICO, nao inferido aqui: exige politica E briefing, os dois
+        // obrigatorios. So checar `politica` vazia deixava passar o caso de politica
+        // existir sem briefing — a sessao seguia como "ok" com metade do briefing faltando,
+        // e nada acionava o fluxo que devia completa-lo.
+        if (!conteudo || payload.briefado === false) {
             return { estado: "sem-politica", esperandoIndexacao };
+        }
         return { estado: "ok", conteudo, esperandoIndexacao };
     }
     catch (erro) {

package/package.json

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