@luanpdd/kit-mcp 1.30.2 → 1.31.0

package/kit/framework/workflows/ship.md

@@ -1,228 +1,228 @@
-<purpose>
-Cria um pull request a partir do trabalho concluído de fase/marco, gera um corpo rico para o PR a partir dos artefatos de planejamento, opcionalmente executa revisão de código e prepara para o merge. Fecha o loop planejar → executar → verificar → publicar.
-</purpose>
-
-<required_reading>
-Leia todos os arquivos referenciados pelo execution_context do prompt invocador antes de começar.
-</required_reading>
-
-<process>
-
-<step name="initialize">
-Analise os argumentos e carregue o estado do projeto:
-
-```bash
-INIT=$(node "./.claude/framework/bin/tools.cjs" init phase-op "${PHASE_ARG}")
-if [[ "$INIT" == @file:* ]]; then INIT=$(cat "${INIT#@file:}"); fi
-```
-
-Analise do JSON do init: `phase_found`, `phase_dir`, `phase_number`, `phase_name`, `padded_phase`, `commit_docs`.
-
-Também carregue o config para a estratégia de branching:
-```bash
-CONFIG=$(node "./.claude/framework/bin/tools.cjs" state load)
-```
-
-Extraia: `branching_strategy`, `branch_name`.
-</step>
-
-<step name="preflight_checks">
-Verifique se o trabalho está pronto para publicar:
-
-1. **Verificação passou?**
-   ```bash
-   VERIFICATION=$(cat ${PHASE_DIR}/*-VERIFICATION.md 2>/dev/null)
-   ```
-   Verifique `status: passed` ou `status: human_needed` (com aprovação humana).
-   Se nenhum VERIFICATION.md ou status for `gaps_found`: avise e peça confirmação do usuário.
-
-2. **Árvore de trabalho limpa?**
-   ```bash
-   git status --short
-   ```
-   Se houver mudanças não commitadas: peça ao usuário para fazer commit ou stash primeiro.
-
-3. **Na branch correta?**
-   ```bash
-   CURRENT_BRANCH=$(git branch --show-current)
-   ```
-   Se estiver em `main`/`master`: avise — deve estar em uma branch de feature.
-   Se a branching_strategy for `none`: ofereça criar uma branch agora.
-
-4. **Remote configurado?**
-   ```bash
-   git remote -v | head -2
-   ```
-   Detecte o remote `origin`. Se nenhum remote: erro — não é possível criar PR.
-
-5. **CLI `gh` disponível?**
-   ```bash
-   which gh && gh auth status 2>&1
-   ```
-   Se `gh` não encontrado ou não autenticado: forneça instruções de configuração e encerre.
-</step>
-
-<step name="push_branch">
-Faça push da branch atual para o remote:
-
-```bash
-git push origin ${CURRENT_BRANCH} 2>&1
-```
-
-Se o push falhar (ex.: sem upstream): defina o upstream:
-```bash
-git push --set-upstream origin ${CURRENT_BRANCH} 2>&1
-```
-
-Reporte: "Push de `{branch}` para origin ({contagem_commits} commits à frente de main)"
-</step>
-
-<step name="generate_pr_body">
-Gere automaticamente um corpo rico para o PR a partir dos artefatos de planejamento:
-
-**1. Título:**
-```
-Fase {número_da_fase}: {nome_da_fase}
-```
-Ou para marco: `Marco {versão}: {nome}`
-
-**2. Seção de Resumo:**
-Leia ROADMAP.md para o objetivo da fase. Leia VERIFICATION.md para o status de verificação.
-
-```markdown
-## Resumo
-
-**Fase {N}: {Nome}**
-**Objetivo:** {objetivo do ROADMAP.md}
-**Status:** Verificado ✓
-
-{Um parágrafo sintetizado dos arquivos SUMMARY.md — o que foi construído}
-```
-
-**3. Seção de Mudanças:**
-Para cada SUMMARY.md no diretório da fase:
-```markdown
-## Mudanças
-
-### Plano {plan_id}: {nome_do_plano}
-{uma_linha do frontmatter do SUMMARY.md}
-
-**Arquivos principais:**
-{key-files.created e key-files.modified do frontmatter do SUMMARY.md}
-```
-
-**4. Seção de Requisitos:**
-```markdown
-## Requisitos Atendidos
-
-{REQ-IDs do frontmatter do plano, vinculados às descrições do REQUIREMENTS.md}
-```
-
-**5. Seção de Testes:**
-```markdown
-## Verificação
-
-- [x] Verificação automatizada: {passou/falhou do VERIFICATION.md}
-- {itens de verificação humana do VERIFICATION.md, se houver}
-```
-
-**6. Seção de Decisões:**
-```markdown
-## Decisões Principais
-
-{Decisões do contexto acumulado do STATE.md relevantes para esta fase}
-```
-</step>
-
-<step name="create_pr">
-Crie o PR usando o corpo gerado:
-
-```bash
-gh pr create \
-  --title "Fase ${PHASE_NUMBER}: ${PHASE_NAME}" \
-  --body "${PR_BODY}" \
-  --base main
-```
-
-Se a flag `--draft` foi passada: adicione `--draft`.
-
-Reporte: "PR #{número} criado: {url}"
-</step>
-
-<step name="optional_review">
-Pergunte se o usuário quer acionar uma revisão de código:
-
-```
-AskUserQuestion:
-  question: "PR criado. Executar revisão de código antes do merge?"
-  options:
-    - label: "Pular revisão"
-      description: "PR está pronto — fazer merge quando CI passar"
-    - label: "Auto-revisão"
-      description: "Vou revisar o diff no PR eu mesmo"
-    - label: "Solicitar revisão"
-      description: "Solicitar revisão de um colega de equipe"
-```
-
-**Se "Solicitar revisão":**
-```bash
-gh pr edit ${PR_NUMBER} --add-reviewer "${REVIEWER}"
-```
-
-**Se "Auto-revisão":**
-Reporte a URL do PR e sugira: "Revise o diff em {url}/files"
-</step>
-
-<step name="track_shipping">
-Atualize o STATE.md para refletir a ação de publicação:
-
-```bash
-node "./.claude/framework/bin/tools.cjs" state update "Last Activity" "$(date +%Y-%m-%d)"
-node "./.claude/framework/bin/tools.cjs" state update "Status" "Fase ${PHASE_NUMBER} publicada — PR #${PR_NUMBER}"
-```
-
-Se `commit_docs` for true:
-```bash
-node "./.claude/framework/bin/tools.cjs" commit "docs(${padded_phase}): publicar fase ${PHASE_NUMBER} — PR #${PR_NUMBER}" --files .planning/STATE.md
-```
-</step>
-
-<step name="report">
-```
-───────────────────────────────────────────────────────────────
-
-## ✓ Fase {X}: {Nome} — Publicada
-
-PR: #{número} ({url})
-Branch: {branch} → main
-Commits: {contagem}
-Verificação: ✓ Passou
-Requisitos: {N} REQ-IDs atendidos
-
-Próximos passos:
-- Revisar/aprovar PR
-- Fazer merge quando CI passar
-- /concluir-marco (se for a última fase do marco)
-- /progresso (para ver o que vem a seguir)
-
-───────────────────────────────────────────────────────────────
-```
-</step>
-
-</process>
-
-<offer_next>
-Após publicar:
-
-- /concluir-marco — se todas as fases do marco estiverem concluídas
-- /progresso — ver o estado geral do projeto
-- /executar-fase {próxima} — continuar para a próxima fase
-</offer_next>
-
-<success_criteria>
-- [ ] Verificações de preflight passaram (verificação, árvore limpa, branch, remote, gh)
-- [ ] Branch enviada para o remote via push
-- [ ] PR criado com corpo rico gerado automaticamente
-- [ ] STATE.md atualizado com status de publicação
-- [ ] Usuário conhece o número do PR e os próximos passos
-</success_criteria>
+<purpose>
+Cria um pull request a partir do trabalho concluído de fase/marco, gera um corpo rico para o PR a partir dos artefatos de planejamento, opcionalmente executa revisão de código e prepara para o merge. Fecha o loop planejar → executar → verificar → publicar.
+</purpose>
+
+<required_reading>
+Leia todos os arquivos referenciados pelo execution_context do prompt invocador antes de começar.
+</required_reading>
+
+<process>
+
+<step name="initialize">
+Analise os argumentos e carregue o estado do projeto:
+
+```bash
+INIT=$(node "./.claude/framework/bin/tools.cjs" init phase-op "${PHASE_ARG}")
+if [[ "$INIT" == @file:* ]]; then INIT=$(cat "${INIT#@file:}"); fi
+```
+
+Analise do JSON do init: `phase_found`, `phase_dir`, `phase_number`, `phase_name`, `padded_phase`, `commit_docs`.
+
+Também carregue o config para a estratégia de branching:
+```bash
+CONFIG=$(node "./.claude/framework/bin/tools.cjs" state load)
+```
+
+Extraia: `branching_strategy`, `branch_name`.
+</step>
+
+<step name="preflight_checks">
+Verifique se o trabalho está pronto para publicar:
+
+1. **Verificação passou?**
+   ```bash
+   VERIFICATION=$(cat ${PHASE_DIR}/*-VERIFICATION.md 2>/dev/null)
+   ```
+   Verifique `status: passed` ou `status: human_needed` (com aprovação humana).
+   Se nenhum VERIFICATION.md ou status for `gaps_found`: avise e peça confirmação do usuário.
+
+2. **Árvore de trabalho limpa?**
+   ```bash
+   git status --short
+   ```
+   Se houver mudanças não commitadas: peça ao usuário para fazer commit ou stash primeiro.
+
+3. **Na branch correta?**
+   ```bash
+   CURRENT_BRANCH=$(git branch --show-current)
+   ```
+   Se estiver em `main`/`master`: avise — deve estar em uma branch de feature.
+   Se a branching_strategy for `none`: ofereça criar uma branch agora.
+
+4. **Remote configurado?**
+   ```bash
+   git remote -v | head -2
+   ```
+   Detecte o remote `origin`. Se nenhum remote: erro — não é possível criar PR.
+
+5. **CLI `gh` disponível?**
+   ```bash
+   which gh && gh auth status 2>&1
+   ```
+   Se `gh` não encontrado ou não autenticado: forneça instruções de configuração e encerre.
+</step>
+
+<step name="push_branch">
+Faça push da branch atual para o remote:
+
+```bash
+git push origin ${CURRENT_BRANCH} 2>&1
+```
+
+Se o push falhar (ex.: sem upstream): defina o upstream:
+```bash
+git push --set-upstream origin ${CURRENT_BRANCH} 2>&1
+```
+
+Reporte: "Push de `{branch}` para origin ({contagem_commits} commits à frente de main)"
+</step>
+
+<step name="generate_pr_body">
+Gere automaticamente um corpo rico para o PR a partir dos artefatos de planejamento:
+
+**1. Título:**
+```
+Fase {número_da_fase}: {nome_da_fase}
+```
+Ou para marco: `Marco {versão}: {nome}`
+
+**2. Seção de Resumo:**
+Leia ROADMAP.md para o objetivo da fase. Leia VERIFICATION.md para o status de verificação.
+
+```markdown
+## Resumo
+
+**Fase {N}: {Nome}**
+**Objetivo:** {objetivo do ROADMAP.md}
+**Status:** Verificado ✓
+
+{Um parágrafo sintetizado dos arquivos SUMMARY.md — o que foi construído}
+```
+
+**3. Seção de Mudanças:**
+Para cada SUMMARY.md no diretório da fase:
+```markdown
+## Mudanças
+
+### Plano {plan_id}: {nome_do_plano}
+{uma_linha do frontmatter do SUMMARY.md}
+
+**Arquivos principais:**
+{key-files.created e key-files.modified do frontmatter do SUMMARY.md}
+```
+
+**4. Seção de Requisitos:**
+```markdown
+## Requisitos Atendidos
+
+{REQ-IDs do frontmatter do plano, vinculados às descrições do REQUIREMENTS.md}
+```
+
+**5. Seção de Testes:**
+```markdown
+## Verificação
+
+- [x] Verificação automatizada: {passou/falhou do VERIFICATION.md}
+- {itens de verificação humana do VERIFICATION.md, se houver}
+```
+
+**6. Seção de Decisões:**
+```markdown
+## Decisões Principais
+
+{Decisões do contexto acumulado do STATE.md relevantes para esta fase}
+```
+</step>
+
+<step name="create_pr">
+Crie o PR usando o corpo gerado:
+
+```bash
+gh pr create \
+  --title "Fase ${PHASE_NUMBER}: ${PHASE_NAME}" \
+  --body "${PR_BODY}" \
+  --base main
+```
+
+Se a flag `--draft` foi passada: adicione `--draft`.
+
+Reporte: "PR #{número} criado: {url}"
+</step>
+
+<step name="optional_review">
+Pergunte se o usuário quer acionar uma revisão de código:
+
+```
+AskUserQuestion:
+  question: "PR criado. Executar revisão de código antes do merge?"
+  options:
+    - label: "Pular revisão"
+      description: "PR está pronto — fazer merge quando CI passar"
+    - label: "Auto-revisão"
+      description: "Vou revisar o diff no PR eu mesmo"
+    - label: "Solicitar revisão"
+      description: "Solicitar revisão de um colega de equipe"
+```
+
+**Se "Solicitar revisão":**
+```bash
+gh pr edit ${PR_NUMBER} --add-reviewer "${REVIEWER}"
+```
+
+**Se "Auto-revisão":**
+Reporte a URL do PR e sugira: "Revise o diff em {url}/files"
+</step>
+
+<step name="track_shipping">
+Atualize o STATE.md para refletir a ação de publicação:
+
+```bash
+node "./.claude/framework/bin/tools.cjs" state update "Last Activity" "$(date +%Y-%m-%d)"
+node "./.claude/framework/bin/tools.cjs" state update "Status" "Fase ${PHASE_NUMBER} publicada — PR #${PR_NUMBER}"
+```
+
+Se `commit_docs` for true:
+```bash
+node "./.claude/framework/bin/tools.cjs" commit "docs(${padded_phase}): publicar fase ${PHASE_NUMBER} — PR #${PR_NUMBER}" --files .planning/STATE.md
+```
+</step>
+
+<step name="report">
+```
+───────────────────────────────────────────────────────────────
+
+## ✓ Fase {X}: {Nome} — Publicada
+
+PR: #{número} ({url})
+Branch: {branch} → main
+Commits: {contagem}
+Verificação: ✓ Passou
+Requisitos: {N} REQ-IDs atendidos
+
+Próximos passos:
+- Revisar/aprovar PR
+- Fazer merge quando CI passar
+- /concluir-marco (se for a última fase do marco)
+- /progresso (para ver o que vem a seguir)
+
+───────────────────────────────────────────────────────────────
+```
+</step>
+
+</process>
+
+<offer_next>
+Após publicar:
+
+- /concluir-marco — se todas as fases do marco estiverem concluídas
+- /progresso — ver o estado geral do projeto
+- /executar-fase {próxima} — continuar para a próxima fase
+</offer_next>
+
+<success_criteria>
+- [ ] Verificações de preflight passaram (verificação, árvore limpa, branch, remote, gh)
+- [ ] Branch enviada para o remote via push
+- [ ] PR criado com corpo rico gerado automaticamente
+- [ ] STATE.md atualizado com status de publicação
+- [ ] Usuário conhece o número do PR e os próximos passos
+</success_criteria>

package/kit/framework/workflows/stats.md

@@ -1,60 +1,60 @@
-<purpose>
-Exibe estatísticas abrangentes do projeto incluindo fases, planos, requisitos, métricas git e linha do tempo.
-</purpose>
-
-<required_reading>
-Leia todos os arquivos referenciados pelo execution_context do prompt invocador antes de começar.
-</required_reading>
-
-<process>
-
-<step name="gather_stats">
-Colete estatísticas do projeto:
-
-```bash
-STATS=$(node "./.claude/framework/bin/tools.cjs" stats json)
-if [[ "$STATS" == @file:* ]]; then STATS=$(cat "${STATS#@file:}"); fi
-```
-
-Extraia campos do JSON: `milestone_version`, `milestone_name`, `phases`, `phases_completed`, `phases_total`, `total_plans`, `total_summaries`, `percent`, `plan_percent`, `requirements_total`, `requirements_complete`, `git_commits`, `git_first_commit_date`, `last_activity`.
-</step>
-
-<step name="present_stats">
-Apresente ao usuário com este formato:
-
-```
-# 📊 Estatísticas do Projeto — {milestone_version} {milestone_name}
-
-## Progresso
-[████████░░] X/Y fases (Z%)
-
-## Planos
-X/Y planos concluídos (Z%)
-
-## Fases
-| Fase | Nome | Planos | Concluídos | Status |
-|------|------|--------|------------|--------|
-| ...  | ...  | ...    | ...        | ...    |
-
-## Requisitos
-✅ X/Y requisitos concluídos
-
-## Git
-- **Commits:** N
-- **Iniciado em:** AAAA-MM-DD
-- **Última atividade:** AAAA-MM-DD
-
-## Linha do Tempo
-- **Idade do projeto:** N dias
-```
-
-Se nenhum diretório `.planning/` existir, informe ao usuário para executar `/novo-projeto` primeiro.
-</step>
-
-</process>
-
-<success_criteria>
-- [ ] Estatísticas coletadas do estado do projeto
-- [ ] Resultados formatados claramente
-- [ ] Exibidos ao usuário
-</success_criteria>
+<purpose>
+Exibe estatísticas abrangentes do projeto incluindo fases, planos, requisitos, métricas git e linha do tempo.
+</purpose>
+
+<required_reading>
+Leia todos os arquivos referenciados pelo execution_context do prompt invocador antes de começar.
+</required_reading>
+
+<process>
+
+<step name="gather_stats">
+Colete estatísticas do projeto:
+
+```bash
+STATS=$(node "./.claude/framework/bin/tools.cjs" stats json)
+if [[ "$STATS" == @file:* ]]; then STATS=$(cat "${STATS#@file:}"); fi
+```
+
+Extraia campos do JSON: `milestone_version`, `milestone_name`, `phases`, `phases_completed`, `phases_total`, `total_plans`, `total_summaries`, `percent`, `plan_percent`, `requirements_total`, `requirements_complete`, `git_commits`, `git_first_commit_date`, `last_activity`.
+</step>
+
+<step name="present_stats">
+Apresente ao usuário com este formato:
+
+```
+# 📊 Estatísticas do Projeto — {milestone_version} {milestone_name}
+
+## Progresso
+[████████░░] X/Y fases (Z%)
+
+## Planos
+X/Y planos concluídos (Z%)
+
+## Fases
+| Fase | Nome | Planos | Concluídos | Status |
+|------|------|--------|------------|--------|
+| ...  | ...  | ...    | ...        | ...    |
+
+## Requisitos
+✅ X/Y requisitos concluídos
+
+## Git
+- **Commits:** N
+- **Iniciado em:** AAAA-MM-DD
+- **Última atividade:** AAAA-MM-DD
+
+## Linha do Tempo
+- **Idade do projeto:** N dias
+```
+
+Se nenhum diretório `.planning/` existir, informe ao usuário para executar `/novo-projeto` primeiro.
+</step>
+
+</process>
+
+<success_criteria>
+- [ ] Estatísticas coletadas do estado do projeto
+- [ ] Resultados formatados claramente
+- [ ] Exibidos ao usuário
+</success_criteria>