@lugom.io/hefesto 0.1.2 → 0.3.0

package/templates/DESIGN.md

@@ -0,0 +1,137 @@
+---
+status: draft
+depth: {{DESIGN_DEPTH}}
+created: {{DATE}}
+updated: {{DATE}}
+---
+
+# Design — {{PROJECT_NAME}}
+
+## Direção Estética
+
+**Estilo:** {{STYLE_NAME}}
+**Propósito:** {{INTERFACE_PURPOSE}}
+**Tom:** {{VISUAL_TONE}}
+**Diferencial:** {{MEMORABLE_ELEMENT}}
+
+> {{STYLE_DESCRIPTION}}
+
+## Contrato de Cores
+
+| Papel | Cor | Uso | % |
+|-------|-----|-----|---|
+| Dominante | {{DOMINANT_COLOR}} | {{DOMINANT_USE}} | 60% |
+| Secundária | {{SECONDARY_COLOR}} | {{SECONDARY_USE}} | 30% |
+| Acento | {{ACCENT_COLOR}} | **Reservado para:** {{ACCENT_RESERVED_LIST}} | 10% |
+
+**Texto sobre dominante:** {{ON_DOMINANT}}
+**Texto sobre secundária:** {{ON_SECONDARY}}
+**Texto sobre acento:** {{ON_ACCENT}}
+
+### Dark Mode
+
+| Papel | Light | Dark |
+|-------|-------|------|
+| Dominante | {{DOMINANT_LIGHT}} | {{DOMINANT_DARK}} |
+| Secundária | {{SECONDARY_LIGHT}} | {{SECONDARY_DARK}} |
+| Acento | {{ACCENT_LIGHT}} | {{ACCENT_DARK}} |
+
+**Contraste AA verificado:** {{CONTRAST_VERIFIED}}
+
+## Contrato de Tipografia
+
+| Nível | Font | Size | Weight | Line Height | Uso |
+|-------|------|------|--------|-------------|-----|
+| Display | {{DISPLAY_FONT}} | {{DISPLAY_SIZE}} | {{DISPLAY_WEIGHT}} | {{DISPLAY_LH}} | {{DISPLAY_USE}} |
+| Heading | {{HEADING_FONT}} | {{HEADING_SIZE}} | {{HEADING_WEIGHT}} | {{HEADING_LH}} | {{HEADING_USE}} |
+| Body | {{BODY_FONT}} | {{BODY_SIZE}} | {{BODY_WEIGHT}} | {{BODY_LH}} | {{BODY_USE}} |
+| Small | {{SMALL_FONT}} | {{SMALL_SIZE}} | {{SMALL_WEIGHT}} | {{SMALL_LH}} | {{SMALL_USE}} |
+
+> Max 4 tamanhos. Max 2 pesos. Sem exceções.
+
+**Fontes bloqueadas:** Inter, Roboto, Arial, system-ui (a menos que justificado no estilo)
+
+## Contrato de Espaçamento
+
+**Escala:** `{{SPACING_SCALE}}`
+**Unidade base:** {{BASE_UNIT}}px
+**Touch targets:** mínimo {{TOUCH_MIN}}px
+
+> Valor fora da escala = bug. Sem exceções.
+
+## Copywriting
+
+| Elemento | Texto |
+|----------|-------|
+| CTA primário | {{PRIMARY_CTA}} |
+| CTA secundário | {{SECONDARY_CTA}} |
+| Empty state | {{EMPTY_STATE}} |
+| Error state | {{ERROR_STATE}} |
+| Loading state | {{LOADING_STATE}} |
+| Confirmação destrutiva | {{DESTRUCTIVE_CONFIRM}} |
+
+**Tom de voz:** {{VOICE_TONE}}
+
+<!-- standard+ -->
+
+## Referências Visuais
+
+| Referência | URL | O que extrair |
+|------------|-----|---------------|
+| {{REF_NAME}} | {{REF_URL}} | {{REF_EXTRACT}} |
+
+## Tokens de Design
+
+### Primitivos (Core)
+
+```css
+:root {
+  {{PRIMITIVE_TOKENS}}
+}
+```
+
+### Semânticos
+
+```css
+:root {
+  {{SEMANTIC_TOKENS}}
+}
+```
+
+### Componente
+
+```css
+{{COMPONENT_TOKENS}}
+```
+
+## Overrides por Contexto
+
+> Overrides são exceções justificadas ao contrato principal. Max 3 contextos.
+> Exemplos: admin vs público, onboarding vs app, marketing vs produto.
+
+| Contexto | O que muda | Valores | Justificativa |
+|----------|-----------|---------|---------------|
+| {{CONTEXT_NAME}} | {{WHAT_CHANGES}} | {{OVERRIDE_VALUES}} | {{JUSTIFICATION}} |
+
+<!-- deep -->
+
+## Specs de Componentes
+
+| Componente | Nível | Variantes | Estados | A11y | Animação |
+|------------|-------|-----------|---------|------|----------|
+| {{COMP_NAME}} | {{ATOMIC_LEVEL}} | {{VARIANTS}} | {{STATES}} | {{A11Y}} | {{ANIMATION}} |
+
+## Prompts para Ferramentas AI
+
+### v0.dev / Lovable / Bolt
+
+```
+{{AI_PROMPT}}
+```
+
+<!-- /deep -->
+<!-- /standard+ -->
+
+## Anti-Padrões Bloqueados
+
+- [ ] {{ANTI_PATTERN_CHECK}}

package/templates/RECON.md

@@ -0,0 +1,54 @@
+## Reconhecimento: {{FEATURE_ID}} — {{FEATURE_TITLE}}
+profundidade: {{DEPTH}}
+
+### 1. Estrutura Relevante
+
+(árvore de diretórios mostrando APENAS o que importa para a feature)
+
+```
+{{RELEVANT_TREE}}
+```
+
+(descrição do que cada arquivo faz e por que é relevante)
+
+### 2. Padrões a Seguir
+
+Para cada tipo de artefato que a feature precisa criar:
+
+**{{ARTIFACT_TYPE}}** — baseado em `{{EXAMPLE_PATH}}:{{LINES}}`
+- Convenção: {{CONVENTION}}
+- Imports: {{IMPORTS}}
+- Exemplo real: (trecho de código copiado do codebase)
+
+### 3. Pontos de Integração
+
+| Arquivo | Ação | O que fazer | Linha |
+|---------|------|-------------|-------|
+| `{{FILE_PATH}}` | modificar | {{ACTION}} | :{{LINE}} |
+| `{{FILE_PATH}}` | criar | {{ACTION}} | — |
+
+### 4. Dependências e Riscos
+
+**Consumers** (importam o que vai mudar):
+- `{{FILE_PATH}}:{{LINE}}` importa `{{MODULE}}`
+
+**Testes adjacentes**:
+- `{{TEST_PATH}}` — {{RELEVANCE}}
+
+**Configs**:
+- `{{CONFIG_FILE}}` precisa de `{{NEW_ENTRY}}`
+
+**Riscos**:
+- Risco: {{RISK}} → Mitigação: {{MITIGATION}}
+
+### 5. Ordem de Ataque
+
+1. **{{TASK_1}}** — {{REASON}} (desbloqueia {{WHAT}})
+2. **{{TASK_2}}** — {{REASON}}
+3. **{{TASK_3}}** — pode ser paralelo com {{N}}
+4. **{{TASK_4}}** — deixar por último ({{REASON}})
+
+### 6. Perguntas Abertas
+
+- {{OPEN_QUESTION_1}}
+- {{OPEN_QUESTION_2}}

package/templates/RESEARCH.md

@@ -0,0 +1,87 @@
+---
+id: {{RESEARCH_ID}}
+title: "{{RESEARCH_TITLE}}"
+type: {{RESEARCH_TYPE}}
+depth: {{RESEARCH_DEPTH}}
+status: draft
+feature: {{LINKED_FEATURE}}
+created: {{DATE}}
+updated: {{DATE}}
+---
+
+# {{RESEARCH_ID}}: {{RESEARCH_TITLE}}
+
+## Objetivo e Escopo
+
+{{RESEARCH_OBJECTIVE}}
+
+**Perguntas a responder:**
+
+1. {{QUESTION_1}}
+2. {{QUESTION_2}}
+3. {{QUESTION_3}}
+
+**Fora do escopo:**
+
+- {{EXCLUSION_1}}
+
+## Recomendação
+
+{{RECOMMENDATION — abordagem recomendada e por quê}}
+
+## Paisagem de Implementação
+
+### Arquivos-chave
+
+- `{{FILE_PATH}}` — {{o que faz e como se relaciona}}
+- `{{FILE_PATH}}` — {{o que precisa mudar}}
+
+### Ordem de Construção
+
+{{o que construir/provar primeiro e por quê — o que desbloqueia trabalho downstream}}
+
+### Verificação
+
+{{como confirmar que funciona — comandos, testes, comportamentos observáveis}}
+
+<!-- Seções abaixo: incluir apenas quando tiverem conteúdo real -->
+
+## Descobertas
+
+### {{FINDING_TITLE_1}}
+
+{{FINDING_CONTENT}}
+
+**Fonte:** [{{SOURCE_TITLE}}]({{SOURCE_URL}}) — Confiabilidade: {{CONFIDENCE}}
+
+### {{FINDING_TITLE_2}}
+
+{{FINDING_CONTENT}}
+
+**Fonte:** [{{SOURCE_TITLE}}]({{SOURCE_URL}}) — Confiabilidade: {{CONFIDENCE}}
+
+## Comparativo
+
+| Critério | {{OPTION_A}} | {{OPTION_B}} | {{OPTION_C}} |
+| -------- | ------------ | ------------ | ------------ |
+| —        | —            | —            | —            |
+
+## Não Reinvente a Roda
+
+| Problema | Solução pronta | Por que não fazer na mão |
+| -------- | -------------- | ------------------------ |
+| —        | —              | —                        |
+
+## Armadilhas
+
+| Severidade | Armadilha | Se ignorar | Prevenção |
+| ---------- | --------- | ---------- | --------- |
+| Crítico    | —         | —          | —         |
+| Moderado   | —         | —          | —         |
+| Menor      | —         | —          | —         |
+
+## Fontes
+
+| # | Título | URL | Confiabilidade |
+| - | ------ | --- | -------------- |
+| 1 | —      | —   | alta           |

package/templates/STATE.md

@@ -30,7 +30,7 @@ Nenhum.
 
 - Última sessão: {{DATE}}
 - Parou em: Inicialização do projeto
-- Retomar: Criar primeira feature com /hefesto:new-feature
+- Retomar: Criar primeira feature com /hefesto-new-feature
 
 ---
 

package/templates/VERDICT.md

@@ -0,0 +1,52 @@
+## Veredicto
+
+status: {{VERDICT_STATUS}}
+feature: {{FEATURE_ID}}
+fase: {{PHASE_NUMBER}}
+
+## Requisitos
+
+| ID     | Requisito              | Status    | Evidência           |
+|--------|------------------------|-----------|---------------------|
+| {{REQ_ID}} | {{REQ_DESCRIPTION}} | {{REQ_STATUS}} | {{REQ_EVIDENCE}} |
+
+## Testes Criados
+
+- `{{TEST_FILE_PATH}}` — {{TEST_COUNT}} testes, {{PASS_COUNT}} pass, {{FAIL_COUNT}} fail
+
+## Edge Cases Encontrados
+
+- {{EDGE_CASE_DESCRIPTION}}
+
+## Fora do Escopo (confirmado)
+
+- {{OUT_OF_SCOPE_ITEM}}
+
+## Questões para o Implementador
+
+1. {{IMPLEMENTER_QUESTION}}
+
+## Auditoria Visual
+
+> Ativada quando `.hefesto/DESIGN.md` existe. Se não existir, omitir esta seção.
+
+design: {{DESIGN_REF}}
+
+### Pilares
+
+| Pilar | Score /4 | Status | Evidência |
+|-------|----------|--------|-----------|
+| Copywriting | {{COPY_SCORE}} | {{COPY_STATUS}} | {{COPY_EVIDENCE}} |
+| Cores (60/30/10) | {{COLOR_SCORE}} | {{COLOR_STATUS}} | {{COLOR_EVIDENCE}} |
+| Tipografia (≤4 sizes, ≤2 weights) | {{TYPO_SCORE}} | {{TYPO_STATUS}} | {{TYPO_EVIDENCE}} |
+| Espaçamento (mult. 4) | {{SPACE_SCORE}} | {{SPACE_STATUS}} | {{SPACE_EVIDENCE}} |
+| Hierarquia visual | {{HIER_SCORE}} | {{HIER_STATUS}} | {{HIER_EVIDENCE}} |
+| Acessibilidade (AA) | {{A11Y_SCORE}} | {{A11Y_STATUS}} | {{A11Y_EVIDENCE}} |
+
+**Score:** {{VISUAL_TOTAL}}/24
+
+### Top 3 Correções
+
+1. {{VISUAL_FIX_1}}
+2. {{VISUAL_FIX_2}}
+3. {{VISUAL_FIX_3}}

package/commands/hefesto/status.md

@@ -1,40 +0,0 @@
----
-description: "Mostra o estado atual do projeto Hefesto. Use /hefesto:status para ver progresso, features ativas, bloqueios e próximos passos."
----
-
-# Hefesto Status
-
-Exibe o estado atual do projeto gerenciado pelo Hefesto.
-
-## Pré-requisitos
-
-Verificar se `.hefesto/` existe. Se não existir, informar que o projeto não foi inicializado e sugerir `/hefesto:init`.
-
-## O que fazer
-
-1. Ler `.hefesto/STATE.md` e exibir o conteúdo formatado.
-2. Ler `.hefesto/ROADMAP.md` e calcular progresso geral.
-3. Listar todas as features em `.hefesto/features/` com seus status (ler frontmatter de cada arquivo).
-4. Apresentar um resumo ao usuário:
-
-```
-📊 Estado do Projeto: [nome]
-
-Progresso: [██████░░░░] 60% (3 de 5 features)
-
-Feature ativa: FEAT-003 — Título (Fase 2 de 4)
-
-Features:
-  ✅ FEAT-001 — Título (done)
-  ✅ FEAT-002 — Título (done)
-  🔄 FEAT-003 — Título (active — fase 2/4)
-  📋 FEAT-004 — Título (ready)
-  📝 FEAT-005 — Título (draft)
-
-Bloqueios: Nenhum
-
-Próximo passo: Continuar execução da Fase 2 de FEAT-003
-```
-
-5. Se houver bloqueios em STATE.md, destacá-los.
-6. Sugerir próxima ação com base no estado atual.