dd-harness 0.37.0 → 0.38.0

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