Pular para o conteúdo
Breaking change

Clickupfy 1.0.0

Confira as mudanças desta versão e os avisos antes de atualizar.

Publicada em
Posição no histórico
9 de 9
Nesta página

Resumo

O ClickUpfy 1.0.0 foi refeito sobre o framework Termfy: um binário único em Bun reúne CLI, TUI e servidor MCP stdio. Os comandos e as ferramentas clickupfy_* da 0.9.0 continuam existindo, com mudanças no formato de saída e nos códigos de saída.

Novidades

  • ClickUpfy 1.0.0 — Perfis e credenciais: as API keys ficam cifradas no cofre em ~/.clickupfy/credentials.json, com perfis em ~/.clickupfy/accounts.json e importação automática do ~/clickupfy/config.json sem alterar o arquivo.
  • ClickUpfy 1.0.0 — Servidor MCP: mcp serve fixa o escopo, inclusive com --sprint-folder e --read-only. mcp --list-id e mcp serve --describe descrevem as ferramentas, e os erros saem com isError e o código de saída equivalente.
  • ClickUpfy 1.0.0 — TUI: a aba Overview mostra perfil, workspace, cronômetro em execução e perfis.
  • ClickUpfy 1.0.0 — Documentação embutida: clickupfy --skill traz a documentação na máquina, e clickupfy --opencli descreve as ferramentas para o OpenCLI.
  • ClickUpfy 1.0.0 — Atualização: upgrade atualiza pelo npm ou troca o binário pela GitHub Release.

Melhorias

  • ClickUpfy 1.0.0 — Cronômetro: iniciar um cronômetro avisa quando outro está ativo numa tarefa diferente e devolve o anterior no campo previous.
  • ClickUpfy 1.0.0 — Documentos: doc page create e doc page update leem o conteúdo de --file <path> ou do stdin com --file -.
  • ClickUpfy 1.0.0 — API: o comando api call <operation> aceita --dry-run e --file repetido. As ferramentas do catálogo deixam de exigir os identificadores fixados pelo servidor e o workspace do perfil.
  • ClickUpfy 1.0.0 — Diagnóstico: doctor confere perfil, API key, configuração antiga, .mcp.json e .codex/config.toml. Com --online, valida a chave e as skills.

Breaking changes

  • ClickUpfy 1.0.0 — Saída JSON: --json usa o envelope { ok, command, data }, e os erros saem como { ok: false, command, error }. Scripts que liam o objeto cru precisam ler .data, e as listas vêm dentro de objetos, como { tasks[] } e { spaces[] }.
  • ClickUpfy 1.0.0 — Idioma e valores: mensagens, opções e campos do --json ficam em inglês. Os estados de item de checklist são done e pending, e os de Sprint são planned, active, completed e regular.
  • ClickUpfy 1.0.0 — Códigos de saída: a tabela acompanha o Termfy, com 2 para uso, 3 para configuração, 4 para credenciais, 5 para rede ou API, 6 para recurso inexistente, 7 para permissão e 130 para interrupção.
  • ClickUpfy 1.0.0 — Filtros e pacote npm: --status e --assignee recebem valores separados por vírgula, e o pacote @promovaweb/clickupfy vira um launcher que baixa o binário da plataforma na primeira execução, conferindo o SHA256SUMS.

Ponto de Atenção

A migração para a 1.0.0 exige revisar scripts que consomem --json e automatizações que leem os códigos de saída. A importação do config.json antigo não altera o arquivo, mas os perfis ficam no cofre.

Teste sugerido: rode clickupfy doctor numa máquina com a configuração antiga e confira o perfil importado. Depois, execute uma consulta com --json e valide o envelope { ok, command, data } no script consumidor. Repita uma chamada com código de uso inválido e confirme o código 2.

Notas da versão

O release oficial do ClickUpfy 1.0.0 foi publicado em 13/11/2026 pelo calendário UTC como versão estável.

Versões anteriores

Esta é a versão mais antiga publicada nesta janela.

Versões posteriores

    • Clickupfy 1.1.1

      O ClickUpfy 1.1.1 restringe a publicação no npm à máquina local.

      Stable
    • Clickupfy 1.1.0

      O ClickUpfy 1.1.0 troca a licença do projeto para a GNU AGPL 3.0.

      Breaking change
    • Clickupfy 1.0.4

      O ClickUpfy 1.0.4 reorganiza o README com o cabeçalho da Promovaweb e os links de documentação, planos e changelog.

      Stable
    • Clickupfy 1.0.3

      O ClickUpfy 1.0.3 encerra a spec 0012 de distribuição, documentação e merge.

      Stable
    • Clickupfy 1.0.2

      O ClickUpfy 1.0.2 reescreve o README para a leitura de uso e cria o guia de contribuição.

      Stable
    • Clickupfy 1.0.1

      O ClickUpfy 1.0.1 corrige o conteúdo da GitHub Release e a publicação no npm.

      Stable
Ver todas as 9 versões do Clickupfy
Histórico de versões