dd-harness 0.37.0 → 0.38.0

package/dist/index.js

@@ -44,94 +44,94 @@ import { REGRA_DE_COMMITS } from "./regras-de-commit.js";
  * em repositorio alheio tem que envelhecer bem, e cada dependencia e uma chance de nao
  * envelhecer.
  */
-const AJUDA = `dd-harness — a política e o Brain do projeto, no serviço
-
-  dd-harness diagnostico [--mcp]    confere projeto, contexto e conexão MCP
-  dd-harness atualizar [--aplicar]  diz o que neste projeto ficou para trás do
-                                     harness atual (CLI, hooks, bloco do
-                                     CLAUDE.md/AGENTS.md) e, com --aplicar,
-                                     atualiza o que é seguro. O que está FORA
-                                     do bloco é do projeto e nunca é tocado
-  dd-harness integrar --host todos  instala MCP/regras/hooks em projeto existente
-  dd-harness sessao --host <host>    hook de boot (stdin JSON)
-  dd-harness guarda --host <host>    hook antes de ferramentas (stdin JSON)
-  dd-harness start [--host <host>]   numa pasta vazia: conduz tudo (login,
-                                     espaço, projeto, config) numa tacada.
-                                     Instala os TRÊS hosts por padrão (claude,
-                                     codex, antigravity) — cada um escreve no
-                                     arquivo que a sua ferramenta lê, sem
-                                     conflito. Use --host claude,codex para
-                                     limitar
-  dd-harness login --token <token> [--api <url>]
-                                     guarda a credencial desta máquina
-  dd-harness projeto <slug> --nome "<nome>" [--tenant <t>] [--api <url>]
-                                     cria o projeto no serviço (antes do init)
-  dd-harness init --tenant <t> --projeto <p> [--api <url>]
-                                     escreve .dd-harness.json; depois rode integrar
-  dd-harness pasta <slug> --definicao "o que entra e o que não entra"
-                                     cria a pasta que o gravar exige
-  dd-harness gravar <arquivo.md>     registra uma memória a partir de um markdown
-  dd-harness editar <arquivo.md>     corrige o que já está gravado
-  dd-harness arquivar <pasta>/<slug> --motivo <obsoleta|incorreta|fora_dos_filtros>
-                     [--substituida-por <pasta>/<slug>]
-                                     tira de circulação sem apagar
-  dd-harness promover <pasta>/<slug>
-                                     torna a memória global: vale para TODO
-                                     projeto do espaço, inclusive os futuros
-  dd-harness despromover <pasta>/<slug>
-                                     traz de volta ao alcance dos vínculos
-  dd-harness apagar <pasta>/<slug> [--confirmar <espaço>]
-                                     apaga de vez, em cascata — sem desfazer.
-                                     Para tirar de circulação guardando o
-                                     conteúdo, use "arquivar"
-  dd-harness buscar "<pergunta>"     acha memória por relevância, não por arquivo
-  dd-harness ler <pasta>/<slug>      imprime a memória inteira, no formato de gravar
-  dd-harness reancorar <pasta>/<slug> --de "<alvo>" --para "<alvo>"
-                                     troca o alvo de uma âncora que mudou de lugar
-  dd-harness check [--commit <sha>]  mede as âncoras e reporta a deriva
-  dd-harness status                  só lê: o tamanho do Brain e o que espera julgamento
-  dd-harness politica [--hook]       imprime a política do serviço
-                                     saída 0 = veio; 3 = projeto sem política;
-                                     1 = não consegui buscar
-                                     --hook: fala o protocolo do SessionStart do
-                                     Claude Code, para pôr a política no contexto
-  dd-harness cinto                  o interceptador pré-voo: lê a edição no stdin
-                                     e devolve a memória que fala daquele trecho.
-                                     Quem chama é o hook PreToolUse, não você
-  dd-harness skills                 as skills deste projeto e quando cada uma serve
-  dd-harness skill <nome>           o procedimento de uma delas (o mesmo que o
-                                     agente recebe ao invocá-la)
-  dd-harness roadmap                as fases abertas: a atual inteira, as próximas
-                                     por título (opcional — projeto sem fase não tem)
-  dd-harness changelog [--versao <v>]
-                                     o que já foi concluído, agrupado por versão
-  dd-harness fase criar --titulo "<t>" [--conteudo <arquivo.md>] [--versao <v>]
-                     [--status ideia|aberta|concluida] [--slug <s>]
-  dd-harness fase editar <slug> [--titulo "<t>"] [--conteudo <arquivo.md>]
-                     [--versao <v> | --sem-versao] [--status <s>] [--ordem <n>]
-                                     concluir = --status concluida: a fase sai do
-                                     roadmap e entra no changelog, nada migra
-  dd-harness --help
-  dd-harness --version              qual binário está instalado nesta máquina
-
-Política e briefing chegam do serviço. O disco guarda configuração, ponteiros
-para skills e estado descartável em ~/.dd-harness. Hosts: claude, codex,
-antigravity, lista separada por vírgulas ou todos.
+const AJUDA = `dd-harness — a política e o Brain do projeto, no serviço
+
+  dd-harness diagnostico [--mcp]    confere projeto, contexto e conexão MCP
+  dd-harness atualizar [--aplicar]  diz o que neste projeto ficou para trás do
+                                     harness atual (CLI, hooks, bloco do
+                                     CLAUDE.md/AGENTS.md) e, com --aplicar,
+                                     atualiza o que é seguro. O que está FORA
+                                     do bloco é do projeto e nunca é tocado
+  dd-harness integrar --host todos  instala MCP/regras/hooks em projeto existente
+  dd-harness sessao --host <host>    hook de boot (stdin JSON)
+  dd-harness guarda --host <host>    hook antes de ferramentas (stdin JSON)
+  dd-harness start [--host <host>]   numa pasta vazia: conduz tudo (login,
+                                     espaço, projeto, config) numa tacada.
+                                     Instala os TRÊS hosts por padrão (claude,
+                                     codex, antigravity) — cada um escreve no
+                                     arquivo que a sua ferramenta lê, sem
+                                     conflito. Use --host claude,codex para
+                                     limitar
+  dd-harness login --token <token> [--api <url>]
+                                     guarda a credencial desta máquina
+  dd-harness projeto <slug> --nome "<nome>" [--tenant <t>] [--api <url>]
+                                     cria o projeto no serviço (antes do init)
+  dd-harness init --tenant <t> --projeto <p> [--api <url>]
+                                     escreve .dd-harness.json; depois rode integrar
+  dd-harness pasta <slug> --definicao "o que entra e o que não entra"
+                                     cria a pasta que o gravar exige
+  dd-harness gravar <arquivo.md>     registra uma memória a partir de um markdown
+  dd-harness editar <arquivo.md>     corrige o que já está gravado
+  dd-harness arquivar <pasta>/<slug> --motivo <obsoleta|incorreta|fora_dos_filtros>
+                     [--substituida-por <pasta>/<slug>]
+                                     tira de circulação sem apagar
+  dd-harness promover <pasta>/<slug>
+                                     torna a memória global: vale para TODO
+                                     projeto do espaço, inclusive os futuros
+  dd-harness despromover <pasta>/<slug>
+                                     traz de volta ao alcance dos vínculos
+  dd-harness apagar <pasta>/<slug> [--confirmar <espaço>]
+                                     apaga de vez, em cascata — sem desfazer.
+                                     Para tirar de circulação guardando o
+                                     conteúdo, use "arquivar"
+  dd-harness buscar "<pergunta>"     acha memória por relevância, não por arquivo
+  dd-harness ler <pasta>/<slug>      imprime a memória inteira, no formato de gravar
+  dd-harness reancorar <pasta>/<slug> --de "<alvo>" --para "<alvo>"
+                                     troca o alvo de uma âncora que mudou de lugar
+  dd-harness check [--commit <sha>]  mede as âncoras e reporta a deriva
+  dd-harness status                  só lê: o tamanho do Brain e o que espera julgamento
+  dd-harness politica [--hook]       imprime a política do serviço
+                                     saída 0 = veio; 3 = projeto sem política;
+                                     1 = não consegui buscar
+                                     --hook: fala o protocolo do SessionStart do
+                                     Claude Code, para pôr a política no contexto
+  dd-harness cinto                  o interceptador pré-voo: lê a edição no stdin
+                                     e devolve a memória que fala daquele trecho.
+                                     Quem chama é o hook PreToolUse, não você
+  dd-harness skills                 as skills deste projeto e quando cada uma serve
+  dd-harness skill <nome>           o procedimento de uma delas (o mesmo que o
+                                     agente recebe ao invocá-la)
+  dd-harness roadmap                as fases abertas: a atual inteira, as próximas
+                                     por título (opcional — projeto sem fase não tem)
+  dd-harness changelog [--versao <v>]
+                                     o que já foi concluído, agrupado por versão
+  dd-harness fase criar --titulo "<t>" [--conteudo <arquivo.md>] [--versao <v>]
+                     [--status ideia|aberta|concluida] [--slug <s>]
+  dd-harness fase editar <slug> [--titulo "<t>"] [--conteudo <arquivo.md>]
+                     [--versao <v> | --sem-versao] [--status <s>] [--ordem <n>]
+                                     concluir = --status concluida: a fase sai do
+                                     roadmap e entra no changelog, nada migra
+  dd-harness --help
+  dd-harness --version              qual binário está instalado nesta máquina
+
+Política e briefing chegam do serviço. O disco guarda configuração, ponteiros
+para skills e estado descartável em ~/.dd-harness. Hosts: claude, codex,
+antigravity, lista separada por vírgulas ou todos.
 `;
 /**
  * Os ganchos sao IMPRESSOS, nunca instalados. `.git/hooks` nao e versionado e nao e
  * nosso: escrever la dentro sem a pessoa pedir e o mesmo tipo de invasao que
  * sobrescrever o CLAUDE.md dela. Quem cola, decide.
  */
-const GANCHOS = `
-Opcional — o gancho que devolve a memória ao code review:
-
-  .git/hooks/post-commit   (avisa quais memórias falam do que você mudou)
-    #!/bin/sh
-    dd-harness check --commit "$(git rev-parse HEAD)" || true
-
-Termina em sucesso mesmo com deriva: avisa, não bloqueia.
-
+const GANCHOS = `
+Opcional — o gancho que devolve a memória ao code review:
+
+  .git/hooks/post-commit   (avisa quais memórias falam do que você mudou)
+    #!/bin/sh
+    dd-harness check --commit "$(git rev-parse HEAD)" || true
+
+Termina em sucesso mesmo com deriva: avisa, não bloqueia.
+
 Instale os hooks de sessão e guarda com \`dd-harness integrar --host <host>\`.`;
 function argumento(argv, nome) {
     const i = argv.indexOf(`--${nome}`);
@@ -166,7 +166,7 @@ async function comandoSkill(argv) {
         throw new Error("uso: dd-harness skill <nome>");
     }
     const s = await leSkill(process.cwd(), slug);
-    console.log(`# ${s.slug}
+    console.log(`# ${s.slug}
 `);
     console.log(s.descricao);
     console.log("");
@@ -260,13 +260,17 @@ function instalaMcp() {
         // pista nenhuma para diagnosticar. O DEP0190 que isto dispara e suprimido no topo
         // do arquivo (`process.removeAllListeners("warning")`).
         //
-        // `@latest` EXPLICITO, e nao `dd-harness-mcp` pelado: sem a tag, o npx serve a copia
-        // que ja estiver no cache dele e nem consulta o registro. Medido na rodada 006 — a
-        // cobaia rodou uma sessao inteira contra um MCP defasado sem nada denunciar. O
-        // `.mcp.json` continua declarando o pacote SEM versao, de proposito: o que precisa
-        // estar fresco e o cache, e fixar versao no arquivo obrigaria a reescrever config em
-        // todo repositorio a cada publicacao.
-        const p = spawn("npx", ["-y", "dd-harness-mcp@latest", "--help"], {
+        // INSTALA, nao aquece cache do npx: o `.mcp.json` passou a declarar `node <caminho>`
+        // em vez de `npx`, porque o host lanca o servidor sem shell e ali nao ha forma de
+        // `npx` que suba no Windows (ENOENT pelado, EINVAL com .cmd). Com o pacote instalado
+        // ha o que apontar, e `integrar` resolve o caminho a partir dele.
+        //
+        // `@latest` EXPLICITO continua valendo, por outro motivo: sem a tag o npm pode dar por
+        // satisfeita a copia que ja esta instalada. Medido na rodada 006 — a cobaia rodou uma
+        // sessao inteira contra um MCP defasado sem nada denunciar. A contrapartida e que a
+        // versao agora fica congelada no caminho declarado: atualizar exige `integrar` de
+        // novo, que e o que o menu de edicao do `start` faz em seguida.
+        const p = spawn("npm", ["install", "-g", "dd-harness-mcp@latest"], {
             shell: process.platform === "win32",
             stdio: "inherit",
         });
@@ -347,6 +351,59 @@ function tentaAbrirNavegador(url) {
 function mascara(token) {
     return token.length <= 16 ? "***" : `${token.slice(0, 12)}...${token.slice(-4)}`;
 }
+/**
+ * `dd-harness start` num repositorio que ja tem config: mostra o estado e edita o que for
+ * escolhido. Nada e reescrito sem a pessoa pedir — "Sair" e uma opcao, e o menu nao tem
+ * acao destrutiva.
+ */
+async function editaProjeto(hosts) {
+    const c = await leConfigDoRepo(process.cwd());
+    const token = await leToken(c.api);
+    console.log(`Projeto: ${c.tenant}/${c.projeto}`);
+    console.log(`Credencial: ${token ? mascara(token) : "ausente"}`);
+    console.log(`API: ${c.api}\n`);
+    const acao = await escolha("O que você quer fazer?", [
+        { rotulo: "Atualizar CLI e MCP", valor: "atualizar" },
+        { rotulo: token ? "Trocar a credencial" : "Colar uma credencial", valor: "token" },
+        { rotulo: "Reinstalar integrações dos hosts", valor: "integrar" },
+        { rotulo: "Sair", valor: "sair" },
+    ]);
+    if (acao === "sair")
+        return;
+    if (acao === "token") {
+        const url = `${c.api}/tokens`;
+        console.log(`\nCrie um token pessoal em ${url} — abrindo no navegador...`);
+        tentaAbrirNavegador(url);
+        const novo = await pergunta("Cole o token aqui: ");
+        if (!novo)
+            throw new Error("nenhum token colado — nada foi alterado.");
+        await guardaToken(c.api, novo);
+        console.log("Credencial guardada.");
+        return;
+    }
+    if (acao === "atualizar") {
+        const desatualizado = await versaoDesatualizada();
+        if (desatualizado) {
+            console.log(`CLI: ${desatualizado.atual} → ${desatualizado.ultima}...`);
+            const ok = await atualizaCli(desatualizado.ultima);
+            console.log(ok
+                ? `CLI atualizado. Este processo segue na ${desatualizado.atual}; do próximo comando em diante, a nova.`
+                : "Não consegui atualizar o CLI — o npm explicou o motivo acima.");
+        }
+        else {
+            console.log("CLI já está na versão mais recente.");
+        }
+        console.log("\nMCP:");
+        const mcp = await instalaMcp();
+        console.log(mcp.ok ? "MCP atualizado." : `AVISO: não consegui instalar o MCP (${mcp.erro ?? "sem detalhe"}).`);
+    }
+    // Tanto "integrar" quanto "atualizar" terminam aqui: depois de instalar uma versao nova
+    // do MCP, o caminho declarado nos arquivos dos hosts aponta para a instalacao antiga ate
+    // alguem regravar. Atualizar sem isto deixaria o projeto rodando o servidor velho.
+    for (const aviso of await instalaHosts(process.cwd(), hosts))
+        console.log("AVISO: " + aviso);
+    console.log("Integrações regravadas: " + hosts.join(", "));
+}
 /**
  * `dd-harness start` — o wizard para pasta vazia.
  *
@@ -367,16 +424,13 @@ async function comandoStart(argv) {
     // aceitando a lista explicita para quem quiser menos.
     const hosts = selecionaHosts(argumento(argv, "host") ?? "todos");
     const caminhoConfig = join(process.cwd(), CAMINHO_CONFIG);
-    try {
-        await access(caminhoConfig);
-        throw new Error(`este repositório já tem ${CAMINHO_CONFIG} — start é só para pasta vazia. ` +
-            "Use `dd-harness init` para ajustar um projeto já existente.");
-    }
-    catch (erro) {
-        if (erro instanceof Error && erro.message.includes("já tem"))
-            throw erro;
-        // ENOENT: exatamente o caso esperado, segue.
-    }
+    // Com config no repositorio, `start` EDITA em vez de recusar. Antes ele mandava usar
+    // `init`, o que exigia saber de cor qual dos quatro comandos serve para que — e o
+    // `start` existe justamente para nao exigir isso. O que se edita e so o que e editavel:
+    // um repositorio E um projeto, entao tenant/projeto nao entram no menu.
+    const jaConfigurado = await access(caminhoConfig).then(() => true, () => false);
+    if (jaConfigurado)
+        return editaProjeto(hosts);
     console.log("Iniciando o dd-harness nesta pasta.\n");
     // 0. Versao. `start` e o comando de bootstrap: rodar velho aqui significa perder
     // correcoes deste proprio wizard sem nenhum aviso (foi o que aconteceu com a
@@ -398,9 +452,14 @@ async function comandoStart(argv) {
     // nao tinha como perceber — o wizard so falhava depois, ao listar espacos.
     let token = await leToken(API_PADRAO);
     if (token) {
-        console.log(`Credencial: ${mascara(token)} (${API_PADRAO})`);
-        const troca = await pergunta("Usar esta credencial? [S/n]: ");
-        if (/^n/i.test(troca))
+        // Escolha nomeada em vez de `[S/n]`: ali o Enter aceitava a credencial salva sem que
+        // ninguem lesse qual era, e um token de outra conta so aparecia como erro varios
+        // passos adiante. Aqui as duas saidas estao escritas, e o valor truncado fica a vista.
+        const usar = await escolha(`Credencial em ${API_PADRAO}:`, [
+            { rotulo: `Usar esta credencial (${mascara(token)})`, valor: true },
+            { rotulo: "Colar outro token", valor: false },
+        ]);
+        if (!usar)
             token = null;
     }
     if (!token) {
@@ -479,13 +538,16 @@ async function comandoStart(argv) {
     // 4. Config do repositorio — o unico arquivo que `init` tambem escreveria.
     const r = await init(process.cwd(), { tenant, projeto: resultadoProjeto.projeto, api: API_PADRAO });
     console.log(r.config === "criada" ? `criado  ${CAMINHO_CONFIG}` : `mantido ${CAMINHO_CONFIG}`);
+    // O MCP vem ANTES das integracoes: `instalaHosts` declara `node <caminho do pacote>`, e
+    // o caminho so existe depois da instalacao. Na ordem inversa a primeira execucao caia no
+    // fallback `npx`, que nao sobe no Windows — e so um segundo `integrar` consertava.
+    const instalacao = await instalaMcp();
+    if (!instalacao.ok)
+        console.log('AVISO: MCP não pré-instalado; execute diagnostico antes de usar.');
     const avisos = await instalaHosts(process.cwd(), hosts);
     console.log('Integrações instaladas: ' + hosts.join(', '));
     for (const aviso of avisos)
         console.log('AVISO: ' + aviso);
-    const instalacao = await instalaMcp();
-    if (!instalacao.ok)
-        console.log('AVISO: MCP não pré-instalado; execute diagnostico antes de usar.');
     // 6.5. Os ponteiros das skills do projeto.
     //
     // O Claude Code descobre skill lendo `.claude/skills/*/SKILL.md` na ABERTURA da sessao,
@@ -653,7 +715,7 @@ async function comandoApagar(argv) {
     if (!r.apagou) {
         console.log(r.detalhe);
         if (r.confirmacaoEsperada) {
-            console.log(`
+            console.log(`
   dd-harness apagar ${endereco} --confirmar ${r.confirmacaoEsperada}`);
         }
         // Sem exit diferente de zero: recusar por falta de confirmacao nao e falha, e o

package/dist/init.js

@@ -8,13 +8,13 @@ import { CAMINHO_CONFIG } from "./config.js";
  * onde falha silenciosa nasce — entrada errada nao da erro, a ferramenta so nao aparece.
  * Quem cola sabe o que colou.
  */
-export const SUGESTAO_MCP = `{
-  "mcpServers": {
-    "dd-harness": {
-      "command": "npx",
-      "args": ["-y", "dd-harness-mcp"]
-    }
-  }
+export const SUGESTAO_MCP = `{
+  "mcpServers": {
+    "dd-harness": {
+      "command": "npx",
+      "args": ["-y", "dd-harness-mcp"]
+    }
+  }
 }`;
 /**
  * Os dois hooks do dd-harness, pelas duas razoes que nenhuma instrucao em markdown
@@ -33,31 +33,31 @@ export const SUGESTAO_MCP = `{
  *
  * Sugerido e nao escrito, pelo mesmo motivo do `.mcp.json`.
  */
-export const SUGESTAO_HOOK = `{
-  "hooks": {
-    "SessionStart": [
-      {
-        "hooks": [
-          {
-            "type": "command",
-            "command": "dd-harness politica --hook",
-            "statusMessage": "Carregando a política do dd-harness..."
-          }
-        ]
-      }
-    ],
-    "PreToolUse": [
-      {
-        "matcher": "Edit|Write|MultiEdit",
-        "hooks": [
-          {
-            "type": "command",
-            "command": "dd-harness cinto"
-          }
-        ]
-      }
-    ]
-  }
+export const SUGESTAO_HOOK = `{
+  "hooks": {
+    "SessionStart": [
+      {
+        "hooks": [
+          {
+            "type": "command",
+            "command": "dd-harness politica --hook",
+            "statusMessage": "Carregando a política do dd-harness..."
+          }
+        ]
+      }
+    ],
+    "PreToolUse": [
+      {
+        "matcher": "Edit|Write|MultiEdit",
+        "hooks": [
+          {
+            "type": "command",
+            "command": "dd-harness cinto"
+          }
+        ]
+      }
+    ]
+  }
 }`;
 /**
  * O que escrever num `AGENTS.md`, para agente que NAO e o Claude Code.
@@ -71,19 +71,19 @@ export const SUGESTAO_HOOK = `{
  * simplesmente nunca perguntar pela politica. Dai esta linha, que e curta de proposito —
  * ela manda buscar a regra, nao repete a regra.
  */
-export const SUGESTAO_AGENTS = `# AGENTS.md
-
-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.
-
-O Claude Code carrega a política sozinho, por hook. Nas outras ferramentas, a
+export const SUGESTAO_AGENTS = `# AGENTS.md
+
+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.
+
+O Claude Code carrega a política sozinho, por hook. Nas outras ferramentas, a
 chamada acima é o que substitui esse hook.`;
 async function declaraMcp(raiz) {
     try {

package/dist/materializa.js

@@ -28,14 +28,9 @@ function secaoDeFiltros(m) {
     ].join("\n");
 }
 export function arquivoDaMemoria(m) {
-    // `titulo` vai no frontmatter porque `gravar` e `editar` o exigem la: sem ele o arquivo
-    // materializado nao volta pelo `editar`, e o ciclo "sincroniza, corrige, manda de volta"
-    // — que e como o agente cura memoria — para com "frontmatter sem `titulo`". O titulo
-    // tambem aparece no indice, mas indice nao e o que se edita.
     const frontmatter = [
         "---",
         `name: ${m.slug}`,
-        `titulo: ${m.titulo.replace(/\n/g, " ")}`,
         `description: ${m.resumo.replace(/\n/g, " ")}`,
         `pasta: ${m.pasta}`,
         ...(m.revisar_ate ? [`revisar-ate: ${m.revisar_ate.slice(0, 10)}`] : []),

package/dist/moldes-historicos.js

@@ -10,81 +10,81 @@
  */
 export const MOLDES_HISTORICOS = [
     // ca1e529
-    `## 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.
-
-Leia também o briefing com a mesma ferramenta (tipo briefing). Os dois são obrigatórios.
-
-Depois, \`ler_roadmap\`: se houver uma fase **Agora**, é dela que saem os passos
-desta sessão. Lista vazia significa que este projeto não usa roadmap, e isso é
-válido — não crie fase sem o usuário pedir.
-
-E \`listar_skills\`: são os procedimentos deste projeto. **Invoque a que couber
-ANTES de fazer o trabalho, não depois** — skill lida no fim vira revisão do que
-já saiu errado, e é tarde.
-
-Vale mesmo quando o pedido parece pequeno: "é só um ajuste" é exatamente a
-frase que antecede pular o procedimento. A política diz quais são obrigatórias
+    `## 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.
+
+Leia também o briefing com a mesma ferramenta (tipo briefing). Os dois são obrigatórios.
+
+Depois, \`ler_roadmap\`: se houver uma fase **Agora**, é dela que saem os passos
+desta sessão. Lista vazia significa que este projeto não usa roadmap, e isso é
+válido — não crie fase sem o usuário pedir.
+
+E \`listar_skills\`: são os procedimentos deste projeto. **Invoque a que couber
+ANTES de fazer o trabalho, não depois** — skill lida no fim vira revisão do que
+já saiu errado, e é tarde.
+
+Vale mesmo quando o pedido parece pequeno: "é só um ajuste" é exatamente a
+frase que antecede pular o procedimento. A política diz quais são obrigatórias
 e quando.`,
     // 875342e
-    `## 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.
-
-Depois, \`ler_roadmap\`: se houver uma fase **Agora**, é dela que saem os passos
-desta sessão. Lista vazia significa que este projeto não usa roadmap, e isso é
-válido — não crie fase sem o usuário pedir.
-
-E \`listar_skills\`: são os procedimentos deste projeto. **Invoque a que couber
-ANTES de fazer o trabalho, não depois** — skill lida no fim vira revisão do que
-já saiu errado, e é tarde.
-
-Vale mesmo quando o pedido parece pequeno: "é só um ajuste" é exatamente a
-frase que antecede pular o procedimento. A política diz quais são obrigatórias
+    `## 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.
+
+Depois, \`ler_roadmap\`: se houver uma fase **Agora**, é dela que saem os passos
+desta sessão. Lista vazia significa que este projeto não usa roadmap, e isso é
+válido — não crie fase sem o usuário pedir.
+
+E \`listar_skills\`: são os procedimentos deste projeto. **Invoque a que couber
+ANTES de fazer o trabalho, não depois** — skill lida no fim vira revisão do que
+já saiu errado, e é tarde.
+
+Vale mesmo quando o pedido parece pequeno: "é só um ajuste" é exatamente a
+frase que antecede pular o procedimento. A política diz quais são obrigatórias
 e quando.`,
     // f59da48
-    `## 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.
-
-Depois, \`ler_roadmap\`: se houver uma fase **Agora**, é dela que saem os passos
-desta sessão. Lista vazia significa que este projeto não usa roadmap, e isso é
+    `## 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.
+
+Depois, \`ler_roadmap\`: se houver uma fase **Agora**, é dela que saem os passos
+desta sessão. Lista vazia significa que este projeto não usa roadmap, e isso é
 válido — não crie fase sem o usuário pedir.`,
     // 5fb3f02
-    `## 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.
+    `## 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/pergunta.d.ts

@@ -1,7 +1,14 @@
 export declare function pergunta(texto: string): Promise<string>;
 export declare function fechaPerguntas(): void;
-/** Numera as opcoes, pede um numero, devolve o item escolhido. Sem loop de retry: erra, recomeca o comando — start nao e ambiente para validar input ao infinito. */
+/**
+ * Escolha de uma opcao: setas e Enter quando ha terminal, numeracao quando nao ha.
+ *
+ * As setas exigem raw mode, que so existe em TTY — e `start` tambem roda com stdin
+ * redirecionado (script, CI, `echo | dd-harness start`). Ali `setRawMode` nem existe, e
+ * chama-lo lanca. Por isso a numeracao continua inteira como caminho alternativo: nao e
+ * legado, e o modo que funciona quando nao ha quem pressione tecla.
+ */
 export declare function escolha<T>(titulo: string, itens: {
     rotulo: string;
     valor: T;
-}[]): Promise<T>;
+}[], inicial?: number): Promise<T>;