Digite para filtrar as páginas da documentação.

    Termfy

    Testar, revisar e publicar

    Acompanhe os testes de aceite nos três modos do Termfy e a revisão por gravidade. Veja como fechar a spec e conferir os binários da release publicada.

    Uma spec só fecha quando os testes de aceite passam. Uma versão só sai quando as specs dela estão fechadas e a revisão não encontrou problema grave. Este capítulo mostra as três skills que cuidam disso: termfy-test, termfy-review e termfy-release.

    1. Testes nos três modos

    Peça:

    Use a skill termfy-test para cobrir os testes da spec 0001.

    A skill lê a seção ## Tests da spec e escreve um teste para cada item, no modo certo. O starter kit já traz um exemplo de cada padrão em tests/.

    Modo Como o teste roda Arquivo de referência
    CLI o binário num subprocesso, com pasta de dados temporária tests/cli.test.ts
    MCP uma conversa real pelo stdio, com o Client do SDK tests/mcp.test.ts
    TUI a interface no renderer de teste do OpenTUI, conferida pelo frame tests/tui.test.ts
    config settings e cofre numa pasta temporária tests/config.test.ts

    CLI num subprocesso

    O teste roda src/main.ts como você rodaria e confere exit code, stdout e stderr. A variável <BIN>_HOME aponta para uma pasta temporária. Assim o teste não mexe no seu ~/.mycli/:

    async function run(args: string[], stdin?: string) {
    const proc = Bun.spawn(["bun", "run", "src/main.ts", ...args], {
    cwd: join(import.meta.dir, ".."),
    env: { ...process.env, [HOME_VARIABLE]: dir, NO_COLOR: "1" },
    stdin: stdin === undefined ? "ignore" : new Response(stdin),
    stdout: "pipe",
    stderr: "pipe",
    });
    const [stdout, stderr] = await Promise.all([new Response(proc.stdout).text(), new Response(proc.stderr).text()]);
    return { code: await proc.exited, stdout, stderr };
    }
    test("config get of an unknown key exits with 3", async () => {
    const r = await run(["config", "get", "does.not.exist", "--json"]);
    expect(r.code).toBe(3);
    expect(JSON.parse(r.stdout).error.name).toBe("CONFIG");
    });

    MCP pelo stdio

    O teste abre o servidor como um cliente de agente abriria e chama as tools pelo protocolo:

    client = new Client({ name: "test", version: "0.0.0" });
    await client.connect(new StdioClientTransport({
    command: "bun",
    args: ["run", "src/main.ts", "mcp"],
    env: { ...(process.env as Record<string, string>), [HOME_VARIABLE]: dir },
    stderr: "ignore",
    }));
    test("credentials_status does not expose values", async () => {
    const r = await client.callTool({ name: "credentials_status", arguments: {} });
    expect(Object.keys(r.structuredContent as object)).not.toContain("values");
    });

    Esse teste pega um problema comum: um console.log esquecido escreve texto em stdout, quebra o JSON-RPC e a conversa com o agente cai.

    TUI pelo frame

    O renderer de teste desenha a interface em memória. O teste envia teclas e confere o texto do frame:

    const setup = await createTestRenderer({ width: 120, height: 32 });
    mountTui(setup.renderer, {});
    await setup.renderOnce();
    expect(setup.captureCharFrame()).toContain("Overview");

    Com cada teste verde, a skill marca [x] no item correspondente de ## Tests. Um item só é marcado depois que o teste roda.

    2. Revisão por gravidade

    Peça:

    Use a skill termfy-review para revisar a entrega da spec 0001.

    A skill lê o diff, a spec e o código e roda as verificações. Ela não edita nada: relata cada achado com gravidade, arquivo, linha, efeito e correção sugerida.

    Nível Quando Exemplo
    P0 segredo real exposto ou perda de dados imediata valor do cofre devolvido por uma tool
    P1 fluxo principal quebrado ou proteção essencial ausente texto em stdout interrompe o JSON-RPC
    P2 comportamento errado localizado ou contrato descumprido exit code errado, option sem description
    P3 apresentação ou manutenção, sem mudar o resultado comentário em português no código

    Um relatório tem esta forma:

    1. [P2] src/cli/commands/orders.ts:31 | Sem shop.token, orders list sai com 5 em vez de 4. | Deixar o erro de getCredential subir sem convertê-lo em erro de rede.
    2. [P3] src/api/shop.ts:12 | Comentário em português. | Traduzir para inglês.
    Testes: bun run validate passou (62 testes).
    Conferência manual: orders_list está no código e falta na Surface da spec.

    Você escolhe o que corrigir. Depois das correções, peça uma revisão nova até não restar P0, P1 nem P2.

    3. Fechar a spec

    Com todas as tarefas e testes marcados, peça à termfy-spec para fechar a spec. O agente aplica a Surface às tabelas do CLISPEC.md, troca o status para done e registra a data. O capítulo Descrever e especificar mostra o ciclo.

    4. Publicar

    Peça:

    Use a skill termfy-release para publicar a versão 0.2.0 do mycli.

    A skill segue esta ordem:

    1. Confere git status, a branch e o índice de specs. Uma spec in_progress com código no repositório indica entrega incompleta.
    2. Atualiza version no package.json e move as entradas de Unreleased para a versão nova no CHANGELOG.md.
    3. Roda bun run opencli se o registry mudou e bun run validate.
    4. Faz o commit release: mycli v0.2.0 e cria a tag v0.2.0.
    5. Envia a main e só essa tag.
    6. Acompanha o workflow release.yml, que compila os cinco executáveis e gera o SHA256SUMS.
    7. Baixa o executável da sua plataforma, confere o checksum e roda --version.

    O changelog segue o formato Keep a Changelog e pode citar as specs:

    ## [0.2.0] - 2026-11-14
    ### Adicionado
    - Command `orders list` e tool `orders_list` para consultar pedidos
    (spec 0001).

    Uma tag publicada não se move. Se o workflow falhar, a correção sai numa versão nova.

    5. Conectar o agente

    Com o binário instalado no PATH, a termfy-mcp-client grava a configuração no cliente de agente que você usa e confere a conexão. A configuração mínima é a mesma que a aba Overview sugere:

    { "command": "mycli", "args": ["mcp"] }

    Próximo passo

    A Parte 3 traz a referência completa: CLI, TUI, MCP, configuração, publicação e uma página por skill.

    Planos Promovaweb

    Tire seus projetos do papel

    O Plano Martech cobre automação e atendimento. O Plano IA Makers acrescenta desenvolvimento com IA, enquanto o Plano Founders trata de gestão de negócios. Todos são anuais.

    Plano Martech

    Para conectar automação, marketing e atendimento com infraestrutura própria.

    R$ 897

    R$ 597/ano

    • Grade de automação, atendimento, marketing e análise de indicadores
    • Instalador Exclusivo Promovaweb
    • n8n, Evolution API, Chatwoot e Mautic
    • Trilha DevOps incluída
    • Encontros ao vivo (terça e quinta)
    • Comunidade e acompanhamento
    Conhecer o plano

    Plano Founders

    Plano anual para fazer um projeto de tecnologia avançar, com 90 dias de mentoria intensiva. R$ 1.997 à vista ou até 10x de R$ 219 no cartão.

    R$ 1.997/ano

    • 12 meses de acesso ao Founders
    • 90 dias de mentoria intensiva, um encontro por dia útil
    • Dia de conteúdo (terça e quinta) e War Room (segunda, quarta e sexta)
    • Encontro semanal em grupo após a fase intensiva
    • Formação Vibe Coding incluída no plano anual
    • Consultoria individual de até duas horas (bônus)
    Conhecer o plano