Smart Task CLI (stc)

Uma ferramenta de linha de comando plugável e altamente resiliente para gerenciar o fluxo de desenvolvimento, conectando-se nativamente a múltiplos providers de gestão de tarefas (Jira, GitHub Issues, ClickUp e Azure DevOps).

🚀 Instalação e Uso

Certifique-se de que possui o Node.js v18+ instalado.

# Clone ou acesse o repositório local
cd smart-task-cli

# Instale as dependências e registre globalmente
npm install
npm link

🔌 Configuração e Autenticação

A stc suporta vários provedores simultâneos, isolando o escopo de cada um no arquivo ~/.stc-config.json. A engine inclui detecção inteligente: se invocada dentro de um repositório git clonado via GitHub ou Azure DevOps, ela autoseleciona o provider correspondente! Caso contrário, utiliza o seu provider Default.

Para autenticar um ou múltiplos provedores, rode:

stc config

O assistente interativo lhe perguntará qual Provider deseja configurar e o guiará sobre as chaves exigidas:

• Jira: OAuth 2.0 Web Auth ou API Token padrão Atlassian.
• GitHub: Classic Personal Access Token (repo scope).
• Azure DevOps: Personal Access Token e nomes da Org/Project.
• ClickUp: Workspace API Key.

Dica: Para acionar o consentimento web OAuth do Jira explicitamente sob demanda, digite stc login.

📋 Comandos Unificados

Os comandos operam rigorosamente da mesma forma independentemente se a sua task pertence ao GitHub, Azure VSTS ou Jira. A arquitetura normaliza as propriedades das APIs via Task Service Core.

• stc list Imprime em formato de tabela as regras e tickets associados ao seu usuário nos backlogs ou Sprints ativos.

• stc start <ID> (Ex: stc start FLCN-123 ou stc start 42) Transita o estado do card iterativamente para a primeira coluna de desenvolvimento listada (ex: In Progress, Em Análise) e simultaneamente copia para o seu Clipboard (Ctrl+C) o briefing técnico da tarefa.

• stc update <ID> (Antigo 'status') Transiciona os tickets livremente. Ao rodar, ele lista todos os campos de coluna disponíveis, permite abrí-lo no seu $EDITOR favorito para escrever e formatar Markdown de comentários e injetá-los diretamente no board, fechando com a mudança de estado.

• stc finish <ID> Robozinho focado em Entregas de Código Acabado! Procura e isola rapidamente colunas conectadas à conclusão morta (ex: Done, Finalizada, Closed) e te dá a oportunidade de injetar o link do Pull Request num comentário final localmente em 1 Segundo.

• stc desc <ID> Captura apenas a descrição Markdown/HTML do ticket e injeta na memória clipboard, permitindo ler as instruções sem transicionar métricas no board.

• stc profile <ação> [nome] O que faz: Gerencia múltiplas contas na CLI (Multi-Profiles). Caso você possua contas em múltiplas "empresas", crie perfis isolados (Ex: stc profile add freela). Essa arquitetura aninha todas as chaves do GitHub, Jira e Azure específicas daquele perfil!

  • list -> Listar os ambientes.
  • use <nome> -> Muda o contexto de requisições.
  • add <nome> / remove <nome>.

🛠 Arquitetura de Providers (Para Contribuir)

Esta CLI foi inteiramente refatorada obedecendo o Design Pattern Adapter. Caso a sua empresa adote um software proprietário, basta acoplar um novo arquivo .js no diretório interno de providers obedecendo a Interface Contratual dos orquestradores. A CLI mapeará as colunas agnósticas (ID, Title, Priority e Status) magicamente pro terminal!