dd-harness 0.13.0 → 0.14.0

package/dist/escreve-config.d.ts

@@ -1,5 +1,5 @@
 /**
- * Escrita de `.claude/settings.json`, `.mcp.json` e `AGENTS.md`, com merge.
+ * Escrita de `.claude/settings.json`, `.mcp.json`, `CLAUDE.md` e `AGENTS.md`, com merge.
  *
  * `init` (o comando antigo) so SUGERE esses arquivos — decisao de proposito, porque
  * mesclar JSON alheio e onde falha silenciosa nasce. `start` (o wizard) reverte essa
@@ -31,11 +31,22 @@ export declare function escreveHook(raiz: string): Promise<ResultadoDaEscrita<"c
 /** Acrescenta o servidor MCP a `.mcp.json`, sem tocar em outros servidores. */
 export declare function escreveMcp(raiz: string): Promise<ResultadoDaEscrita<"criado" | "ja-tinha" | "acrescentado">>;
 /**
- * `AGENTS.md` e markdown livre, nao JSON — nao ha "mesclar" de verdade. Se o arquivo ja
- * existe (com qualquer conteudo), so acrescenta a instrucao no fim; nunca sobrescreve
- * o que a pessoa escreveu, porque markdown de outra ferramenta e mais dificil de separar
- * do nosso do que uma chave de objeto.
+ * Os dois pontos de entrada do repositorio — `CLAUDE.md` (Claude Code) e `AGENTS.md`
+ * (Codex, Cursor, Gemini CLI, Windsurf) — sao ESPELHOS: o mesmo apontamento para o
+ * dd-harness, sem regra propria. Nenhum dos dois e opcional, e nao ha pergunta sobre
+ * "qual ferramenta voce usa": quem abre o repositorio encontra o protocolo pela porta
+ * que a SUA ferramenta le, e as duas dizem a mesma coisa. Regra fica no servico; aqui
+ * fica so o ponteiro — por isso espelhar nao duplica nada que possa divergir.
+ *
+ * Markdown e livre, nao JSON: nao ha "mesclar" de verdade. Se o arquivo ja existe (com
+ * qualquer conteudo), so acrescenta a instrucao no fim; nunca sobrescreve o que a pessoa
+ * escreveu, porque markdown alheio e mais dificil de separar do nosso do que uma chave
+ * de objeto.
  */
-export declare function escreveAgents(raiz: string): Promise<{
+export declare function escrevePonteiro(raiz: string, arquivo: "AGENTS.md" | "CLAUDE.md"): Promise<{
+    estado: "criado" | "ja-tinha" | "acrescentado";
+}>;
+/** Compatibilidade: `init` ainda chama pelo nome antigo. */
+export declare const escreveAgents: (raiz: string) => Promise<{
     estado: "criado" | "ja-tinha" | "acrescentado";
 }>;

package/dist/escreve-config.js

@@ -63,13 +63,20 @@ export async function escreveMcp(raiz) {
     return { ok: true, estado: eraVazio ? "criado" : "acrescentado" };
 }
 /**
- * `AGENTS.md` e markdown livre, nao JSON — nao ha "mesclar" de verdade. Se o arquivo ja
- * existe (com qualquer conteudo), so acrescenta a instrucao no fim; nunca sobrescreve
- * o que a pessoa escreveu, porque markdown de outra ferramenta e mais dificil de separar
- * do nosso do que uma chave de objeto.
+ * Os dois pontos de entrada do repositorio — `CLAUDE.md` (Claude Code) e `AGENTS.md`
+ * (Codex, Cursor, Gemini CLI, Windsurf) — sao ESPELHOS: o mesmo apontamento para o
+ * dd-harness, sem regra propria. Nenhum dos dois e opcional, e nao ha pergunta sobre
+ * "qual ferramenta voce usa": quem abre o repositorio encontra o protocolo pela porta
+ * que a SUA ferramenta le, e as duas dizem a mesma coisa. Regra fica no servico; aqui
+ * fica so o ponteiro — por isso espelhar nao duplica nada que possa divergir.
+ *
+ * Markdown e livre, nao JSON: nao ha "mesclar" de verdade. Se o arquivo ja existe (com
+ * qualquer conteudo), so acrescenta a instrucao no fim; nunca sobrescreve o que a pessoa
+ * escreveu, porque markdown alheio e mais dificil de separar do nosso do que uma chave
+ * de objeto.
  */
-export async function escreveAgents(raiz) {
-    const caminho = join(raiz, "AGENTS.md");
+export async function escrevePonteiro(raiz, arquivo) {
+    const caminho = join(raiz, arquivo);
     const instrucao = SUGESTAO_AGENTS;
     let atual = null;
     try {
@@ -88,14 +95,16 @@ export async function escreveAgents(raiz) {
     await writeFile(caminho, `${atual}${separador}${instrucao}\n`, "utf8");
     return { estado: "acrescentado" };
 }
-const SUGESTAO_AGENTS = `## Protocolo do dd-harness
-
-Este projeto tem um protocolo de trabalho que **não está neste arquivo**.
-
-**ANTES de qualquer outra coisa**, chame a ferramenta MCP \`ler_artefato\` com
-\`tipo: "politica"\` e siga o que ela devolver. É a primeira ação da sessão, antes
-de ler código, responder ou planejar.
-
-- Se a ferramenta não existir, o servidor MCP do dd-harness não está declarado:
-  avise o usuário e **não modifique nada** até ele resolver.
+/** Compatibilidade: `init` ainda chama pelo nome antigo. */
+export const escreveAgents = (raiz) => escrevePonteiro(raiz, "AGENTS.md");
+const SUGESTAO_AGENTS = `## Protocolo do dd-harness
+
+Este projeto tem um protocolo de trabalho que **não está neste arquivo**.
+
+**ANTES de qualquer outra coisa**, chame a ferramenta MCP \`ler_artefato\` com
+\`tipo: "politica"\` e siga o que ela devolver. É a primeira ação da sessão, antes
+de ler código, responder ou planejar.
+
+- Se a ferramenta não existir, o servidor MCP do dd-harness não está declarado:
+  avise o usuário e **não modifique nada** até ele resolver.
 - Se ela devolver vazio, este projeto nunca foi briefado — diga isso ao usuário.`;

package/dist/index.js

@@ -14,7 +14,7 @@ process.removeAllListeners("warning");
 import { termosDaConsulta } from "./argv.js";
 import { check, status } from "./check.js";
 import { CAMINHO_CONFIG, guardaConfigDaMaquina, guardaToken, leConfigDaMaquina, leConfigDoRepo, leToken, } from "./config.js";
-import { escreveAgents, escreveHook, escreveMcp } from "./escreve-config.js";
+import { escreveHook, escreveMcp, escrevePonteiro } from "./escreve-config.js";
 import { grava } from "./gravar.js";
 import { init, SUGESTAO_AGENTS, SUGESTAO_HOOK, SUGESTAO_MCP } from "./init.js";
 import { pergunta, escolha, fechaPerguntas } from "./pergunta.js";
@@ -287,15 +287,18 @@ async function comandoStart() {
                 "conexão do Claude Code pode demorar ou falhar; se falhar, abra uma nova sessão " +
                 "e tente de novo.");
     }
-    // 6. AGENTS.md — so quem usa outra ferramenta alem do Claude Code precisa.
-    const outraFerramenta = await pergunta("\nVai abrir este projeto em Codex, Cursor ou outra ferramenta além do Claude " +
-        "Code? [s/N]: ");
-    if (/^s/i.test(outraFerramenta)) {
-        const agents = await escreveAgents(process.cwd());
-        console.log({ criado: "criado  AGENTS.md",
-            "ja-tinha": "mantido AGENTS.md — já apontava para a política",
-            acrescentado: "atualizado AGENTS.md (instrução acrescentada ao que já existia)",
-        }[agents.estado]);
+    // 6. CLAUDE.md e AGENTS.md — os dois SEMPRE, sem perguntar. Sao espelhos: o mesmo
+    // apontamento para o servico, cada um na porta que uma familia de ferramenta le. A
+    // pergunta "usa outra ferramenta?" saiu porque a resposta nao muda nada que valha a
+    // pena — quem responde "nao" hoje abre o repositorio no Cursor semana que vem e nao
+    // encontra protocolo nenhum, e o custo de ja ter o arquivo e um ponteiro de 8 linhas.
+    console.log("");
+    for (const arquivo of ["CLAUDE.md", "AGENTS.md"]) {
+        const r = await escrevePonteiro(process.cwd(), arquivo);
+        console.log({ criado: `criado  ${arquivo}`,
+            "ja-tinha": `mantido ${arquivo} — já apontava para a política`,
+            acrescentado: `atualizado ${arquivo} (apontamento acrescentado ao que já existia)`,
+        }[r.estado]);
     }
     // 7. Onde esta o monorepo do worker nesta maquina? So pergunta uma vez, e so importa
     // se houver memoria na fila agora — pular aqui nao trava nada, so avisa mais vezes.

package/package.json

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