@luanpdd/kit-mcp 1.20.0 → 1.21.0

package/kit/framework/workflows/check-todos.md

@@ -1,177 +1,177 @@
-<purpose>
-Listar todos os todos pendentes, permitir seleção, carregar contexto completo do todo selecionado e encaminhar para a ação adequada.
-</purpose>
-
-<required_reading>
-Leia todos os arquivos referenciados pelo execution_context do prompt que invocou antes de começar.
-</required_reading>
-
-<process>
-
-<step name="init_context">
-Carregar contexto de todos:
-
-```bash
-INIT=$(node "./.claude/framework/bin/tools.cjs" init todos)
-if [[ "$INIT" == @file:* ]]; then INIT=$(cat "${INIT#@file:}"); fi
-```
-
-Extrair do JSON de init: `todo_count`, `todos`, `pending_dir`.
-
-Se `todo_count` for 0:
-```
-Nenhum todo pendente.
-
-Todos são capturados durante sessões de trabalho com /adicionar-tarefa.
-
----
-
-Deseja:
-
-1. Continuar com a fase atual (/progresso)
-2. Adicionar um todo agora (/adicionar-tarefa)
-```
-
-Sair.
-</step>
-
-<step name="parse_filter">
-Verificar filtro de área nos argumentos:
-- `/verificar-tarefas` → mostrar todos
-- `/verificar-tarefas api` → filtrar apenas para area:api
-</step>
-
-<step name="list_todos">
-Usar o array `todos` do contexto de init (já filtrado por área se especificado).
-
-Analisar e exibir como lista numerada:
-
-```
-Todos Pendentes:
-
-1. Adicionar refresh de token auth (api, há 2 dias)
-2. Corrigir problema de z-index do modal (ui, há 1 dia)
-3. Refatorar pool de conexão do banco de dados (database, há 5h)
-
----
-
-Responda com um número para ver detalhes, ou:
-- `/verificar-tarefas [área]` para filtrar por área
-- `q` para sair
-```
-
-Formatar idade como tempo relativo a partir do timestamp criado.
-</step>
-
-<step name="handle_selection">
-Aguardar o usuário responder com um número.
-
-Se válido: carregar todo selecionado, prosseguir.
-Se inválido: "Seleção inválida. Responda com um número (1-[N]) ou `q` para sair."
-</step>
-
-<step name="load_context">
-Ler o arquivo de todo completamente. Exibir:
-
-```
-## [título]
-
-**Área:** [área]
-**Criado:** [data] (há [tempo relativo])
-**Arquivos:** [lista ou "Nenhum"]
-
-### Problema
-[conteúdo da seção de problema]
-
-### Solução
-[conteúdo da seção de solução]
-```
-
-Se o campo `files` tiver entradas, leia e resuma brevemente cada um.
-</step>
-
-<step name="check_roadmap">
-Verificar roadmap (pode usar init progress ou verificar existência de arquivo diretamente):
-
-Se `.planning/ROADMAP.md` existir:
-1. Verificar se a área do todo corresponde a uma fase futura
-2. Verificar se os arquivos do todo se sobrepõem ao escopo de uma fase
-3. Anotar qualquer correspondência para as opções de ação
-</step>
-
-<step name="offer_actions">
-**Se o todo mapear para uma fase do roadmap:**
-
-Usar AskUserQuestion:
-- header: "Ação"
-- question: "Este todo está relacionado à Fase [N]: [nome]. O que você gostaria de fazer?"
-- options:
-  - "Trabalhar nisso agora" — mover para feito, começar a trabalhar
-  - "Adicionar ao plano da fase" — incluir ao planejar a Fase [N]
-  - "Explorar abordagem" — pensar antes de decidir
-  - "Devolver" — retornar à lista
-
-**Se não houver correspondência no roadmap:**
-
-Usar AskUserQuestion:
-- header: "Ação"
-- question: "O que você gostaria de fazer com este todo?"
-- options:
-  - "Trabalhar nisso agora" — mover para feito, começar a trabalhar
-  - "Criar uma fase" — /adicionar-fase com este escopo
-  - "Explorar abordagem" — pensar antes de decidir
-  - "Devolver" — retornar à lista
-</step>
-
-<step name="execute_action">
-**Trabalhar nisso agora:**
-```bash
-mv ".planning/todos/pending/[filename]" ".planning/todos/done/"
-```
-Atualizar contagem de todos no STATE.md. Apresentar contexto do problema/solução. Começar o trabalho ou perguntar como prosseguir.
-
-**Adicionar ao plano da fase:**
-Anotar referência do todo nas notas de planejamento da fase. Manter no pendente. Retornar à lista ou sair.
-
-**Criar uma fase:**
-Exibir: `/adicionar-fase [descrição do todo]`
-Manter no pendente. Usuário executa o comando em contexto novo.
-
-**Explorar abordagem:**
-Manter no pendente. Iniciar discussão sobre o problema e abordagens.
-
-**Devolver:**
-Retornar ao passo list_todos.
-</step>
-
-<step name="update_state">
-Após qualquer ação que altere a contagem de todos:
-
-Re-executar `init todos` para obter contagem atualizada, depois atualizar seção "### Pending Todos" do STATE.md se existir.
-</step>
-
-<step name="git_commit">
-Se o todo foi movido para done/, commitar a mudança:
-
-```bash
-git rm --cached .planning/todos/pending/[filename] 2>/dev/null || true
-node "./.claude/framework/bin/tools.cjs" commit "docs: start work on todo - [título]" --files .planning/todos/done/[filename] .planning/STATE.md
-```
-
-A ferramenta respeita a configuração `commit_docs` e gitignore automaticamente.
-
-Confirmar: "Commitado: docs: start work on todo - [título]"
-</step>
-
-</process>
-
-<success_criteria>
-- [ ] Todos os todos pendentes listados com título, área, idade
-- [ ] Filtro de área aplicado se especificado
-- [ ] Contexto completo do todo selecionado carregado
-- [ ] Contexto do roadmap verificado para correspondência de fase
-- [ ] Ações adequadas oferecidas
-- [ ] Ação selecionada executada
-- [ ] STATE.md atualizado se contagem de todos mudou
-- [ ] Mudanças commitadas no git (se todo movido para done/)
-</success_criteria>
+<purpose>
+Listar todos os todos pendentes, permitir seleção, carregar contexto completo do todo selecionado e encaminhar para a ação adequada.
+</purpose>
+
+<required_reading>
+Leia todos os arquivos referenciados pelo execution_context do prompt que invocou antes de começar.
+</required_reading>
+
+<process>
+
+<step name="init_context">
+Carregar contexto de todos:
+
+```bash
+INIT=$(node "./.claude/framework/bin/tools.cjs" init todos)
+if [[ "$INIT" == @file:* ]]; then INIT=$(cat "${INIT#@file:}"); fi
+```
+
+Extrair do JSON de init: `todo_count`, `todos`, `pending_dir`.
+
+Se `todo_count` for 0:
+```
+Nenhum todo pendente.
+
+Todos são capturados durante sessões de trabalho com /adicionar-tarefa.
+
+---
+
+Deseja:
+
+1. Continuar com a fase atual (/progresso)
+2. Adicionar um todo agora (/adicionar-tarefa)
+```
+
+Sair.
+</step>
+
+<step name="parse_filter">
+Verificar filtro de área nos argumentos:
+- `/verificar-tarefas` → mostrar todos
+- `/verificar-tarefas api` → filtrar apenas para area:api
+</step>
+
+<step name="list_todos">
+Usar o array `todos` do contexto de init (já filtrado por área se especificado).
+
+Analisar e exibir como lista numerada:
+
+```
+Todos Pendentes:
+
+1. Adicionar refresh de token auth (api, há 2 dias)
+2. Corrigir problema de z-index do modal (ui, há 1 dia)
+3. Refatorar pool de conexão do banco de dados (database, há 5h)
+
+---
+
+Responda com um número para ver detalhes, ou:
+- `/verificar-tarefas [área]` para filtrar por área
+- `q` para sair
+```
+
+Formatar idade como tempo relativo a partir do timestamp criado.
+</step>
+
+<step name="handle_selection">
+Aguardar o usuário responder com um número.
+
+Se válido: carregar todo selecionado, prosseguir.
+Se inválido: "Seleção inválida. Responda com um número (1-[N]) ou `q` para sair."
+</step>
+
+<step name="load_context">
+Ler o arquivo de todo completamente. Exibir:
+
+```
+## [título]
+
+**Área:** [área]
+**Criado:** [data] (há [tempo relativo])
+**Arquivos:** [lista ou "Nenhum"]
+
+### Problema
+[conteúdo da seção de problema]
+
+### Solução
+[conteúdo da seção de solução]
+```
+
+Se o campo `files` tiver entradas, leia e resuma brevemente cada um.
+</step>
+
+<step name="check_roadmap">
+Verificar roadmap (pode usar init progress ou verificar existência de arquivo diretamente):
+
+Se `.planning/ROADMAP.md` existir:
+1. Verificar se a área do todo corresponde a uma fase futura
+2. Verificar se os arquivos do todo se sobrepõem ao escopo de uma fase
+3. Anotar qualquer correspondência para as opções de ação
+</step>
+
+<step name="offer_actions">
+**Se o todo mapear para uma fase do roadmap:**
+
+Usar AskUserQuestion:
+- header: "Ação"
+- question: "Este todo está relacionado à Fase [N]: [nome]. O que você gostaria de fazer?"
+- options:
+  - "Trabalhar nisso agora" — mover para feito, começar a trabalhar
+  - "Adicionar ao plano da fase" — incluir ao planejar a Fase [N]
+  - "Explorar abordagem" — pensar antes de decidir
+  - "Devolver" — retornar à lista
+
+**Se não houver correspondência no roadmap:**
+
+Usar AskUserQuestion:
+- header: "Ação"
+- question: "O que você gostaria de fazer com este todo?"
+- options:
+  - "Trabalhar nisso agora" — mover para feito, começar a trabalhar
+  - "Criar uma fase" — /adicionar-fase com este escopo
+  - "Explorar abordagem" — pensar antes de decidir
+  - "Devolver" — retornar à lista
+</step>
+
+<step name="execute_action">
+**Trabalhar nisso agora:**
+```bash
+mv ".planning/todos/pending/[filename]" ".planning/todos/done/"
+```
+Atualizar contagem de todos no STATE.md. Apresentar contexto do problema/solução. Começar o trabalho ou perguntar como prosseguir.
+
+**Adicionar ao plano da fase:**
+Anotar referência do todo nas notas de planejamento da fase. Manter no pendente. Retornar à lista ou sair.
+
+**Criar uma fase:**
+Exibir: `/adicionar-fase [descrição do todo]`
+Manter no pendente. Usuário executa o comando em contexto novo.
+
+**Explorar abordagem:**
+Manter no pendente. Iniciar discussão sobre o problema e abordagens.
+
+**Devolver:**
+Retornar ao passo list_todos.
+</step>
+
+<step name="update_state">
+Após qualquer ação que altere a contagem de todos:
+
+Re-executar `init todos` para obter contagem atualizada, depois atualizar seção "### Pending Todos" do STATE.md se existir.
+</step>
+
+<step name="git_commit">
+Se o todo foi movido para done/, commitar a mudança:
+
+```bash
+git rm --cached .planning/todos/pending/[filename] 2>/dev/null || true
+node "./.claude/framework/bin/tools.cjs" commit "docs: start work on todo - [título]" --files .planning/todos/done/[filename] .planning/STATE.md
+```
+
+A ferramenta respeita a configuração `commit_docs` e gitignore automaticamente.
+
+Confirmar: "Commitado: docs: start work on todo - [título]"
+</step>
+
+</process>
+
+<success_criteria>
+- [ ] Todos os todos pendentes listados com título, área, idade
+- [ ] Filtro de área aplicado se especificado
+- [ ] Contexto completo do todo selecionado carregado
+- [ ] Contexto do roadmap verificado para correspondência de fase
+- [ ] Ações adequadas oferecidas
+- [ ] Ação selecionada executada
+- [ ] STATE.md atualizado se contagem de todos mudou
+- [ ] Mudanças commitadas no git (se todo movido para done/)
+</success_criteria>

package/kit/framework/workflows/cleanup.md

@@ -1,152 +1,152 @@
-<purpose>
-
-Arquivar diretórios de fase acumulados de milestones concluídos em `.planning/milestones/v{X.Y}-phases/`. Identifica quais fases pertencem a cada milestone concluído, mostra um resumo de simulação e move os diretórios após confirmação.
-
-</purpose>
-
-<required_reading>
-
-1. `.planning/MILESTONES.md`
-2. Listagem do diretório `.planning/milestones/`
-3. Listagem do diretório `.planning/phases/`
-
-</required_reading>
-
-<process>
-
-<step name="identify_completed_milestones">
-
-Leia `.planning/MILESTONES.md` para identificar milestones concluídos e suas versões.
-
-```bash
-cat .planning/MILESTONES.md
-```
-
-Extrair cada versão de milestone (ex: v1.0, v1.1, v2.0).
-
-Verificar quais diretórios de arquivo de milestone já existem:
-
-```bash
-ls -d .planning/milestones/v*-phases 2>/dev/null || true
-```
-
-Filtrar para milestones que NÃO têm ainda um diretório de arquivo `-phases`.
-
-Se todos os milestones já tiverem arquivos de fase:
-
-```
-Todos os milestones concluídos já têm diretórios de fase arquivados. Nada para limpar.
-```
-
-Parar aqui.
-
-</step>
-
-<step name="determine_phase_membership">
-
-Para cada milestone concluído sem arquivo `-phases`, leia o snapshot de ROADMAP arquivado para determinar quais fases pertencem a ele:
-
-```bash
-cat .planning/milestones/v{X.Y}-ROADMAP.md
-```
-
-Extrair números e nomes de fase do roadmap arquivado (ex: Fase 1: Foundation, Fase 2: Auth).
-
-Verificar quais desses diretórios de fase ainda existem em `.planning/phases/`:
-
-```bash
-ls -d .planning/phases/*/ 2>/dev/null || true
-```
-
-Corresponder diretórios de fase à associação de milestone. Incluir apenas diretórios que ainda existem em `.planning/phases/`.
-
-</step>
-
-<step name="show_dry_run">
-
-Apresentar um resumo de simulação para cada milestone:
-
-```
-## Resumo de Limpeza
-
-### v{X.Y} — {Nome do Milestone}
-Estes diretórios de fase serão arquivados:
-- 01-foundation/
-- 02-auth/
-- 03-core-features/
-
-Destino: .planning/milestones/v{X.Y}-phases/
-
-### v{X.Z} — {Nome do Milestone}
-Estes diretórios de fase serão arquivados:
-- 04-security/
-- 05-hardening/
-
-Destino: .planning/milestones/v{X.Z}-phases/
-```
-
-Se nenhum diretório de fase permanecer para arquivar (todos já movidos ou deletados):
-
-```
-Nenhum diretório de fase encontrado para arquivar. As fases podem ter sido removidas ou arquivadas anteriormente.
-```
-
-Parar aqui.
-
-AskUserQuestion: "Prosseguir com o arquivamento?" com opções: "Sim — arquivar fases listadas" | "Cancelar"
-
-Se "Cancelar": Parar.
-
-</step>
-
-<step name="archive_phases">
-
-Para cada milestone, mover diretórios de fase:
-
-```bash
-mkdir -p .planning/milestones/v{X.Y}-phases
-```
-
-Para cada diretório de fase pertencente a este milestone:
-
-```bash
-mv .planning/phases/{dir} .planning/milestones/v{X.Y}-phases/
-```
-
-Repetir para todos os milestones no conjunto de limpeza.
-
-</step>
-
-<step name="commit">
-
-Commitar as mudanças:
-
-```bash
-node "./.claude/framework/bin/tools.cjs" commit "chore: archive phase directories from completed milestones" --files .planning/milestones/ .planning/phases/
-```
-
-</step>
-
-<step name="report">
-
-```
-Arquivado:
-{Para cada milestone}
-- v{X.Y}: {N} diretórios de fase → .planning/milestones/v{X.Y}-phases/
-
-.planning/phases/ limpo.
-```
-
-</step>
-
-</process>
-
-<success_criteria>
-
-- [ ] Todos os milestones concluídos sem arquivos de fase existentes identificados
-- [ ] Associação de fase determinada a partir de snapshots de ROADMAP arquivados
-- [ ] Resumo de simulação mostrado e confirmado pelo usuário
-- [ ] Diretórios de fase movidos para `.planning/milestones/v{X.Y}-phases/`
-- [ ] Mudanças commitadas
-
-</success_criteria>
+<purpose>
+
+Arquivar diretórios de fase acumulados de milestones concluídos em `.planning/milestones/v{X.Y}-phases/`. Identifica quais fases pertencem a cada milestone concluído, mostra um resumo de simulação e move os diretórios após confirmação.
+
+</purpose>
+
+<required_reading>
+
+1. `.planning/MILESTONES.md`
+2. Listagem do diretório `.planning/milestones/`
+3. Listagem do diretório `.planning/phases/`
+
+</required_reading>
+
+<process>
+
+<step name="identify_completed_milestones">
+
+Leia `.planning/MILESTONES.md` para identificar milestones concluídos e suas versões.
+
+```bash
+cat .planning/MILESTONES.md
+```
+
+Extrair cada versão de milestone (ex: v1.0, v1.1, v2.0).
+
+Verificar quais diretórios de arquivo de milestone já existem:
+
+```bash
+ls -d .planning/milestones/v*-phases 2>/dev/null || true
+```
+
+Filtrar para milestones que NÃO têm ainda um diretório de arquivo `-phases`.
+
+Se todos os milestones já tiverem arquivos de fase:
+
+```
+Todos os milestones concluídos já têm diretórios de fase arquivados. Nada para limpar.
+```
+
+Parar aqui.
+
+</step>
+
+<step name="determine_phase_membership">
+
+Para cada milestone concluído sem arquivo `-phases`, leia o snapshot de ROADMAP arquivado para determinar quais fases pertencem a ele:
+
+```bash
+cat .planning/milestones/v{X.Y}-ROADMAP.md
+```
+
+Extrair números e nomes de fase do roadmap arquivado (ex: Fase 1: Foundation, Fase 2: Auth).
+
+Verificar quais desses diretórios de fase ainda existem em `.planning/phases/`:
+
+```bash
+ls -d .planning/phases/*/ 2>/dev/null || true
+```
+
+Corresponder diretórios de fase à associação de milestone. Incluir apenas diretórios que ainda existem em `.planning/phases/`.
+
+</step>
+
+<step name="show_dry_run">
+
+Apresentar um resumo de simulação para cada milestone:
+
+```
+## Resumo de Limpeza
+
+### v{X.Y} — {Nome do Milestone}
+Estes diretórios de fase serão arquivados:
+- 01-foundation/
+- 02-auth/
+- 03-core-features/
+
+Destino: .planning/milestones/v{X.Y}-phases/
+
+### v{X.Z} — {Nome do Milestone}
+Estes diretórios de fase serão arquivados:
+- 04-security/
+- 05-hardening/
+
+Destino: .planning/milestones/v{X.Z}-phases/
+```
+
+Se nenhum diretório de fase permanecer para arquivar (todos já movidos ou deletados):
+
+```
+Nenhum diretório de fase encontrado para arquivar. As fases podem ter sido removidas ou arquivadas anteriormente.
+```
+
+Parar aqui.
+
+AskUserQuestion: "Prosseguir com o arquivamento?" com opções: "Sim — arquivar fases listadas" | "Cancelar"
+
+Se "Cancelar": Parar.
+
+</step>
+
+<step name="archive_phases">
+
+Para cada milestone, mover diretórios de fase:
+
+```bash
+mkdir -p .planning/milestones/v{X.Y}-phases
+```
+
+Para cada diretório de fase pertencente a este milestone:
+
+```bash
+mv .planning/phases/{dir} .planning/milestones/v{X.Y}-phases/
+```
+
+Repetir para todos os milestones no conjunto de limpeza.
+
+</step>
+
+<step name="commit">
+
+Commitar as mudanças:
+
+```bash
+node "./.claude/framework/bin/tools.cjs" commit "chore: archive phase directories from completed milestones" --files .planning/milestones/ .planning/phases/
+```
+
+</step>
+
+<step name="report">
+
+```
+Arquivado:
+{Para cada milestone}
+- v{X.Y}: {N} diretórios de fase → .planning/milestones/v{X.Y}-phases/
+
+.planning/phases/ limpo.
+```
+
+</step>
+
+</process>
+
+<success_criteria>
+
+- [ ] Todos os milestones concluídos sem arquivos de fase existentes identificados
+- [ ] Associação de fase determinada a partir de snapshots de ROADMAP arquivados
+- [ ] Resumo de simulação mostrado e confirmado pelo usuário
+- [ ] Diretórios de fase movidos para `.planning/milestones/v{X.Y}-phases/`
+- [ ] Mudanças commitadas
+
+</success_criteria>