dd-harness 0.36.0 → 0.38.0

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>;

package/dist/pergunta.js

@@ -18,8 +18,21 @@ export function fechaPerguntas() {
     rl?.close();
     rl = null;
 }
-/** 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. */
-export async function escolha(titulo, itens) {
+/**
+ * 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 async function escolha(titulo, itens, inicial = 0) {
+    if (!itens.length)
+        throw new Error("escolha: nenhuma opção para escolher.");
+    const porTecla = Boolean(process.stdin.isTTY) && typeof process.stdin.setRawMode === "function";
+    return porTecla ? porSetas(titulo, itens, inicial) : porNumero(titulo, itens);
+}
+async function porNumero(titulo, itens) {
     console.log(titulo);
     itens.forEach((item, i) => console.log(`  ${i + 1}) ${item.rotulo}`));
     const resposta = await pergunta("> ");
@@ -29,3 +42,59 @@ export async function escolha(titulo, itens) {
         throw new Error(`escolha um número entre 1 e ${itens.length}.`);
     return escolhido.valor;
 }
+function porSetas(titulo, itens, inicial) {
+    return new Promise((resolve, reject) => {
+        // A interface de linha e a das setas disputam o mesmo stdin: com as duas ativas, cada
+        // tecla chega duas vezes. Esta fecha e a proxima `pergunta` abre outra.
+        fechaPerguntas();
+        let atual = Math.min(Math.max(inicial, 0), itens.length - 1);
+        let primeiraPintura = true;
+        const pinta = () => {
+            // Sobe e limpa as linhas da pintura anterior; na primeira vez nao ha o que apagar.
+            if (!primeiraPintura)
+                process.stdout.write(`\x1b[${itens.length}A\x1b[0J`);
+            primeiraPintura = false;
+            for (const [i, item] of itens.entries()) {
+                const alvo = i === atual;
+                // Negrito no selecionado, cinza no resto: a seta sozinha se perde quando a lista
+                // passa de tres ou quatro itens.
+                process.stdout.write(alvo ? `\x1b[1m❯ ${item.rotulo}\x1b[0m\n` : `\x1b[2m  ${item.rotulo}\x1b[0m\n`);
+            }
+        };
+        const encerra = () => {
+            process.stdin.setRawMode(false);
+            process.stdin.pause();
+            process.stdin.off("data", aoTeclar);
+        };
+        const aoTeclar = (dado) => {
+            const tecla = dado.toString();
+            // Ctrl+C precisa continuar matando o processo: em raw mode o terminal nao o trata
+            // mais sozinho, e sem isto o wizard ficaria impossivel de abortar.
+            if (tecla === "\x03") {
+                encerra();
+                process.stdout.write("\n");
+                process.exit(130);
+            }
+            if (tecla === "\x1b[A" || tecla === "k") {
+                atual = (atual - 1 + itens.length) % itens.length;
+                pinta();
+            }
+            else if (tecla === "\x1b[B" || tecla === "j") {
+                atual = (atual + 1) % itens.length;
+                pinta();
+            }
+            else if (tecla === "\r" || tecla === "\n") {
+                encerra();
+                const escolhido = itens[atual];
+                if (!escolhido)
+                    return reject(new Error("escolha: índice fora da lista."));
+                resolve(escolhido.valor);
+            }
+        };
+        console.log(titulo);
+        pinta();
+        process.stdin.setRawMode(true);
+        process.stdin.resume();
+        process.stdin.on("data", aoTeclar);
+    });
+}

package/dist/regras-de-commit.js

@@ -1,12 +1,12 @@
 /** Regra do produto, entregue junto da política sem reescrever o artefato no serviço. */
-export const REGRA_DE_COMMITS = `## Identificação do agente nos commits
-
-Todo commit feito por agente começa com [IDENTIFICAÇÃO] - tipo: descrição.
-Exemplos: [CODEX] - feat: nova funcionalidade; [CLAUDE] - fix: corrige a busca;
-[GEMINI] - docs: atualiza o guia. Outro agente usa seu nome em maiúsculas entre colchetes.
-Identifique o agente/modelo que efetivamente realizou o commit, não apenas o editor:
-Claude no Antigravity continua [CLAUDE]; Gemini usa [GEMINI]; Codex usa [CODEX].
-Não invente a identidade. A regra não concede autorização para commitar, não altera
+export const REGRA_DE_COMMITS = `## Identificação do agente nos commits
+
+Todo commit feito por agente começa com [IDENTIFICAÇÃO] - tipo: descrição.
+Exemplos: [CODEX] - feat: nova funcionalidade; [CLAUDE] - fix: corrige a busca;
+[GEMINI] - docs: atualiza o guia. Outro agente usa seu nome em maiúsculas entre colchetes.
+Identifique o agente/modelo que efetivamente realizou o commit, não apenas o editor:
+Claude no Antigravity continua [CLAUDE]; Gemini usa [GEMINI]; Codex usa [CODEX].
+Não invente a identidade. A regra não concede autorização para commitar, não altera
 o autor do Git e não pede reescrita de commits antigos.`;
 export function politicaParaSessao(conteudo) {
     if (!conteudo.trim() || conteudo.includes(REGRA_DE_COMMITS))