@dewtech/dare-cli 3.3.0 → 3.4.0

package/templates/ide/claude/.claude/commands/dare-dag-run.md

@@ -1,109 +1,109 @@
-# /dare-dag-run
-
-Executa o grafo de tasks definido em `DARE/dare-dag.yaml` usando **Claude
-Code como executor** e o CLI `dare` como orquestrador. O canvas ao vivo fica
-em `DARE/.canvas.md`.
-
-> **Sem API keys.** Você (Claude Code) usa o plano da IDE/CLI em que o
-> usuário já está autenticado. O CLI apenas coordena estado, monta prompts
-> e atualiza canvas.
-
-## Pré-requisitos
-
-- `DARE/dare-dag.yaml` existe e foi aprovado
-- Specs em `DARE/EXECUTION/task-<id>.md` geradas
-- `dare` disponível no PATH (`npm i -g @dewtech/dare-cli`)
-
-## Como usar
-
-```
-/dare-dag-run
-/dare-dag-run --task task-003    # executar só uma task específica
-```
-
-## O que fazer
-
-### 1. Validar pré-condições
-
-- Confirme que `DARE/dare-dag.yaml` existe. Se não, oriente
-  `/dare-blueprint` ou `/dare-dag-build`
-- Leia o YAML e verifique sem ciclos, ids únicos, ranks paralelizáveis
-
-### 2. Pegar próximas tasks
-
-```bash
-dare execute --next
-```
-
-O CLI imprime as tasks ready do rank atual com o prompt completo (snippets
-de até 2000 chars dos outputs dos pais já costurados). Use esses prompts.
-
-### 3. Sugerir abrir o canvas
-
-Antes de começar, peça ao usuário abrir `DARE/.canvas.md` em outra aba.
-
-### 4. Executar cada task
-
-Para cada task ready:
-
-1. Leia `spec_file` se houver
-2. Implemente conforme o prompt
-3. Rode Ralph Loop: build → test → lint
-4. Registre o resultado:
-
-```bash
-# Sucesso
-dare execute --complete task-001 --output "Resumo + arquivos criados (paths)"
-
-# Falha
-dare execute --fail task-002 --reason "Mensagem clara da falha"
-```
-
-### 5. Avançar de rank
-
-```bash
-dare execute --next
-```
-
-Se aparece `✅ All tasks resolved`, todas terminaram. Caso contrário, continue.
-
-### 6. Pós-execução
-
-```bash
-dare execute --status
-```
-
-Para retentar tasks FAILED:
-
-```bash
-dare execute --reset task-002
-dare execute --next
-```
-
-## Comandos do orquestrador
-
-| Comando | Função |
-|---------|--------|
-| `dare execute --next` | Próximas tasks ready com prompts compostos |
-| `dare execute --complete <id> --output "…"` | Marca DONE |
-| `dare execute --fail <id> --reason "…"` | Marca FAILED + cascade-skip |
-| `dare execute --reset <id>` | Volta para PENDING |
-| `dare execute --status` | Snapshot do canvas + sumário |
-
-## Erros comuns
-
-| Sintoma | Causa | Correção |
-|---------|-------|----------|
-| `dare-dag.yaml not found` | Não foi gerado | `/dare-blueprint` ou `/dare-dag-build` |
-| Cascata de SKIPPED | Pai falhou | Corrija pai → `--reset` → `--next` |
-| Output truncado | Cap de 4000 chars | Escreva em arquivo, retorne resumo |
-| Spec inconsistente | TASKS.md ≠ dare-dag.yaml | Re-gere com `/dare-dag-build` |
-
-## Referências
-
-- Schema: `DARE/dare-dag.yaml`
-- Canvas: `DARE/.canvas.md`
-- Specs: `DARE/EXECUTION/task-*.md`
-- Status: `DARE/TASKS.md`
-
-$ARGUMENTS
+# /dare-dag-run
+
+Executa o grafo de tasks definido em `DARE/dare-dag.yaml` usando **Claude
+Code como executor** e o CLI `dare` como orquestrador. O canvas ao vivo fica
+em `DARE/.canvas.md`.
+
+> **Sem API keys.** Você (Claude Code) usa o plano da IDE/CLI em que o
+> usuário já está autenticado. O CLI apenas coordena estado, monta prompts
+> e atualiza canvas.
+
+## Pré-requisitos
+
+- `DARE/dare-dag.yaml` existe e foi aprovado
+- Specs em `DARE/EXECUTION/task-<id>.md` geradas
+- `dare` disponível no PATH (`npm i -g @dewtech/dare-cli`)
+
+## Como usar
+
+```
+/dare-dag-run
+/dare-dag-run --task task-003    # executar só uma task específica
+```
+
+## O que fazer
+
+### 1. Validar pré-condições
+
+- Confirme que `DARE/dare-dag.yaml` existe. Se não, oriente
+  `/dare-blueprint` ou `/dare-dag-build`
+- Leia o YAML e verifique sem ciclos, ids únicos, ranks paralelizáveis
+
+### 2. Pegar próximas tasks
+
+```bash
+dare execute --next
+```
+
+O CLI imprime as tasks ready do rank atual com o prompt completo (snippets
+de até 2000 chars dos outputs dos pais já costurados). Use esses prompts.
+
+### 3. Sugerir abrir o canvas
+
+Antes de começar, peça ao usuário abrir `DARE/.canvas.md` em outra aba.
+
+### 4. Executar cada task
+
+Para cada task ready:
+
+1. Leia `spec_file` se houver
+2. Implemente conforme o prompt
+3. Rode Ralph Loop: build → test → lint
+4. Registre o resultado:
+
+```bash
+# Sucesso
+dare execute --complete task-001 --output "Resumo + arquivos criados (paths)"
+
+# Falha
+dare execute --fail task-002 --reason "Mensagem clara da falha"
+```
+
+### 5. Avançar de rank
+
+```bash
+dare execute --next
+```
+
+Se aparece `✅ All tasks resolved`, todas terminaram. Caso contrário, continue.
+
+### 6. Pós-execução
+
+```bash
+dare execute --status
+```
+
+Para retentar tasks FAILED:
+
+```bash
+dare execute --reset task-002
+dare execute --next
+```
+
+## Comandos do orquestrador
+
+| Comando | Função |
+|---------|--------|
+| `dare execute --next` | Próximas tasks ready com prompts compostos |
+| `dare execute --complete <id> --output "…"` | Marca DONE |
+| `dare execute --fail <id> --reason "…"` | Marca FAILED + cascade-skip |
+| `dare execute --reset <id>` | Volta para PENDING |
+| `dare execute --status` | Snapshot do canvas + sumário |
+
+## Erros comuns
+
+| Sintoma | Causa | Correção |
+|---------|-------|----------|
+| `dare-dag.yaml not found` | Não foi gerado | `/dare-blueprint` ou `/dare-dag-build` |
+| Cascata de SKIPPED | Pai falhou | Corrija pai → `--reset` → `--next` |
+| Output truncado | Cap de 4000 chars | Escreva em arquivo, retorne resumo |
+| Spec inconsistente | TASKS.md ≠ dare-dag.yaml | Re-gere com `/dare-dag-build` |
+
+## Referências
+
+- Schema: `DARE/dare-dag.yaml`
+- Canvas: `DARE/.canvas.md`
+- Specs: `DARE/EXECUTION/task-*.md`
+- Status: `DARE/TASKS.md`
+
+$ARGUMENTS

package/templates/ide/claude/.claude/commands/dare-dag-runner.md

@@ -1,117 +1,117 @@
-# /dare-dag-runner
-
-Wrapper agregador que cobre **todo o ciclo do DAG** num único comando:
-build do `dare-dag.yaml` (se necessário) → execução de todas as tasks via
-Ralph Loop → opcional visualização final em Excalidraw.
-
-Esta skill existe por **paridade conceitual** com Antigravity e Cursor, que
-consolidam build + run numa única skill chamada `dare-dag-runner`. No Claude
-você também tem os comandos granulares `/dare-dag-build`, `/dare-dag-run` e
-`/dare-dag-viz` caso prefira controle fino.
-
-> **Sem API keys.** Você (Claude Code) usa o plano da IDE/CLI em que o
-> usuário já está autenticado. O CLI `dare` apenas coordena estado, monta
-> prompts e atualiza canvas.
-
-## Como usar
-
-```
-/dare-dag-runner                 # build + run completo, com viz opcional ao final
-/dare-dag-runner --skip-build    # pula build, executa o yaml atual
-/dare-dag-runner --skip-run      # só (re)gera o yaml, não executa
-/dare-dag-runner --viz           # ao final, gera dag-graph.excalidraw
-/dare-dag-runner --task task-003 # executa apenas uma task específica
-```
-
-## Quando usar
-
-- Você quer rodar **todo o ciclo** sem se preocupar com comandos separados
-- Está começando a fase EXECUTE pela primeira vez num projeto
-- Quer paridade com o fluxo do Antigravity/Cursor (1 skill = ciclo completo)
-
-## Quando NÃO usar
-
-- Você quer **só** regerar o yaml (sem executar) → use `/dare-dag-build`
-- Você quer **só** executar o yaml atual (sem regerar) → use `/dare-dag-run`
-- Você quer **só** o diagrama Excalidraw → use `/dare-dag-viz`
-- O BLUEPRINT está desatualizado → atualize primeiro com `/dare-blueprint`
-
-## Pré-requisitos
-
-- `DARE/BLUEPRINT.md` existe e está aprovado (a fase build precisa dele)
-- `dare` disponível no PATH (`npm i -g @dewtech/dare-cli`)
-
-## O que fazer
-
-### Fase 1 — BUILD (se aplicável)
-
-Se o yaml não existe ou está stale (BLUEPRINT mais novo que o yaml),
-execute o procedimento completo de `/dare-dag-build`:
-
-1. Ler `DARE/BLUEPRINT.md`
-2. Ler `DARE/dare-dag.yaml` atual (preservar `id`s)
-3. Gerar o novo `dare-dag.yaml` obedecendo:
-   - `id` em kebab-case e único
-   - `depends_on` mínimo
-   - `subtask_prompt` self-contained
-   - Pelo menos **2 tasks no rank 0**
-   - Cadeia linear é antipattern
-   - `complexity` honesta
-   - ANTI-STUB CONTRACT em cada spec (ver `/dare-dag-build` para detalhes)
-4. Atualizar `DARE/TASKS.md`
-5. **Pedir aprovação ao usuário antes de executar.**
-
-Se `--skip-build` foi passado, pule esta fase.
-
-### Fase 2 — RUN
-
-Executa o procedimento completo de `/dare-dag-run`:
-
-1. Validar pré-condições (yaml existe, sem ciclos, ids únicos)
-2. Sugerir abrir `DARE/.canvas.md` em outra aba
-3. Loop até `✅ All tasks resolved`:
-   - `dare execute --next` para pegar tasks ready do rank atual
-   - Para cada task: ler spec → implementar (sem mock fora de tests, sem TODOs) → Ralph Loop (build/test/lint) → `dare execute --complete <id> --output "..."` ou `--fail <id> --reason "..."`
-4. Pós-execução: `dare execute --status` para sumário final
-
-Se `--skip-run` foi passado, pule esta fase.
-
-### Fase 3 — VIZ (opcional)
-
-Se `--viz` foi passado, ao final gere `DARE/dag-graph.excalidraw` via
-`/dare-dag-viz`: retângulos coloridos por complexidade, swim lanes por
-rank, setas para `depends_on`, status visual (DONE/RUNNING/FAILED).
-
-## Comandos do orquestrador `dare`
-
-| Comando | Função |
-|---------|--------|
-| `dare execute --next` | Próximas tasks ready com prompts compostos |
-| `dare execute --complete <id> --output "..."` | Marca DONE |
-| `dare execute --fail <id> --reason "..."` | Marca FAILED + cascade-skip |
-| `dare execute --reset <id>` | Volta para PENDING |
-| `dare execute --status` | Snapshot + sumário |
-
-## Mensagem final ao usuário
-
-> Ciclo DAG completo:
-> - Build: N tasks geradas em M ranks (ou "pulado" se --skip-build)
-> - Run: X DONE / Y FAILED / Z SKIPPED
-> - Viz: `DARE/dag-graph.excalidraw` (se --viz)
->
-> Para retentar falhas: `/dare-dag-run` (ou comando granular).
-
-## Equivalência entre IDEs
-
-| Operação | Antigravity | Claude | Cursor |
-|----------|-------------|--------|--------|
-| Ciclo completo | `dare-dag-runner` | `/dare-dag-runner` (este) | `skill-dag-runner` rule |
-| Só build | `dare-dag-build` | `/dare-dag-build` | `skill-dag-build` rule |
-| Só run | `dare-dag-run` | `/dare-dag-run` | `skill-dag-run` rule + `/run-dag` |
-| Visualizar | `dare-dag-viz` | `/dare-dag-viz` | `/dag-viz` |
-
-## Licença
-
-Esta skill é parte do DARE Method e está sob licença MIT (D-001).
-
-$ARGUMENTS
+# /dare-dag-runner
+
+Wrapper agregador que cobre **todo o ciclo do DAG** num único comando:
+build do `dare-dag.yaml` (se necessário) → execução de todas as tasks via
+Ralph Loop → opcional visualização final em Excalidraw.
+
+Esta skill existe por **paridade conceitual** com Antigravity e Cursor, que
+consolidam build + run numa única skill chamada `dare-dag-runner`. No Claude
+você também tem os comandos granulares `/dare-dag-build`, `/dare-dag-run` e
+`/dare-dag-viz` caso prefira controle fino.
+
+> **Sem API keys.** Você (Claude Code) usa o plano da IDE/CLI em que o
+> usuário já está autenticado. O CLI `dare` apenas coordena estado, monta
+> prompts e atualiza canvas.
+
+## Como usar
+
+```
+/dare-dag-runner                 # build + run completo, com viz opcional ao final
+/dare-dag-runner --skip-build    # pula build, executa o yaml atual
+/dare-dag-runner --skip-run      # só (re)gera o yaml, não executa
+/dare-dag-runner --viz           # ao final, gera dag-graph.excalidraw
+/dare-dag-runner --task task-003 # executa apenas uma task específica
+```
+
+## Quando usar
+
+- Você quer rodar **todo o ciclo** sem se preocupar com comandos separados
+- Está começando a fase EXECUTE pela primeira vez num projeto
+- Quer paridade com o fluxo do Antigravity/Cursor (1 skill = ciclo completo)
+
+## Quando NÃO usar
+
+- Você quer **só** regerar o yaml (sem executar) → use `/dare-dag-build`
+- Você quer **só** executar o yaml atual (sem regerar) → use `/dare-dag-run`
+- Você quer **só** o diagrama Excalidraw → use `/dare-dag-viz`
+- O BLUEPRINT está desatualizado → atualize primeiro com `/dare-blueprint`
+
+## Pré-requisitos
+
+- `DARE/BLUEPRINT.md` existe e está aprovado (a fase build precisa dele)
+- `dare` disponível no PATH (`npm i -g @dewtech/dare-cli`)
+
+## O que fazer
+
+### Fase 1 — BUILD (se aplicável)
+
+Se o yaml não existe ou está stale (BLUEPRINT mais novo que o yaml),
+execute o procedimento completo de `/dare-dag-build`:
+
+1. Ler `DARE/BLUEPRINT.md`
+2. Ler `DARE/dare-dag.yaml` atual (preservar `id`s)
+3. Gerar o novo `dare-dag.yaml` obedecendo:
+   - `id` em kebab-case e único
+   - `depends_on` mínimo
+   - `subtask_prompt` self-contained
+   - Pelo menos **2 tasks no rank 0**
+   - Cadeia linear é antipattern
+   - `complexity` honesta
+   - ANTI-STUB CONTRACT em cada spec (ver `/dare-dag-build` para detalhes)
+4. Atualizar `DARE/TASKS.md`
+5. **Pedir aprovação ao usuário antes de executar.**
+
+Se `--skip-build` foi passado, pule esta fase.
+
+### Fase 2 — RUN
+
+Executa o procedimento completo de `/dare-dag-run`:
+
+1. Validar pré-condições (yaml existe, sem ciclos, ids únicos)
+2. Sugerir abrir `DARE/.canvas.md` em outra aba
+3. Loop até `✅ All tasks resolved`:
+   - `dare execute --next` para pegar tasks ready do rank atual
+   - Para cada task: ler spec → implementar (sem mock fora de tests, sem TODOs) → Ralph Loop (build/test/lint) → `dare execute --complete <id> --output "..."` ou `--fail <id> --reason "..."`
+4. Pós-execução: `dare execute --status` para sumário final
+
+Se `--skip-run` foi passado, pule esta fase.
+
+### Fase 3 — VIZ (opcional)
+
+Se `--viz` foi passado, ao final gere `DARE/dag-graph.excalidraw` via
+`/dare-dag-viz`: retângulos coloridos por complexidade, swim lanes por
+rank, setas para `depends_on`, status visual (DONE/RUNNING/FAILED).
+
+## Comandos do orquestrador `dare`
+
+| Comando | Função |
+|---------|--------|
+| `dare execute --next` | Próximas tasks ready com prompts compostos |
+| `dare execute --complete <id> --output "..."` | Marca DONE |
+| `dare execute --fail <id> --reason "..."` | Marca FAILED + cascade-skip |
+| `dare execute --reset <id>` | Volta para PENDING |
+| `dare execute --status` | Snapshot + sumário |
+
+## Mensagem final ao usuário
+
+> Ciclo DAG completo:
+> - Build: N tasks geradas em M ranks (ou "pulado" se --skip-build)
+> - Run: X DONE / Y FAILED / Z SKIPPED
+> - Viz: `DARE/dag-graph.excalidraw` (se --viz)
+>
+> Para retentar falhas: `/dare-dag-run` (ou comando granular).
+
+## Equivalência entre IDEs
+
+| Operação | Antigravity | Claude | Cursor |
+|----------|-------------|--------|--------|
+| Ciclo completo | `dare-dag-runner` | `/dare-dag-runner` (este) | `skill-dag-runner` rule |
+| Só build | `dare-dag-build` | `/dare-dag-build` | `skill-dag-build` rule |
+| Só run | `dare-dag-run` | `/dare-dag-run` | `skill-dag-run` rule + `/run-dag` |
+| Visualizar | `dare-dag-viz` | `/dare-dag-viz` | `/dag-viz` |
+
+## Licença
+
+Esta skill é parte do DARE Method e está sob licença MIT (D-001).
+
+$ARGUMENTS