@dewtech/dare-cli 3.3.0 → 3.4.0

package/templates/ide/claude/.claude/commands/dare-quality-telemetry.md

@@ -1,166 +1,166 @@
-# /dare-quality-telemetry
-
-Coleta métricas das skills DARE (ax, layered-design, llm-integration, frontend, realtime…), persiste histórico em `tmp/dare_metrics.json` e detecta regressões contra baseline.
-
-## Como usar
-
-```
-/dare-quality-telemetry collect          # roda todos os collectors
-/dare-quality-telemetry baseline         # captura baseline atual
-/dare-quality-telemetry compare          # compara contra baseline (CI)
-/dare-quality-telemetry report           # gera markdown report
-```
-
-## O que faz
-
-1. Roda collectors das skills configuradas em paralelo
-2. Agrega em um snapshot
-3. Persiste em `tmp/dare_metrics.json`
-4. Compara com `tmp/dare_metrics_baseline.json`
-5. Reporta em markdown / JSON
-6. Exit code ≠ 0 se regressão crítica
-
-## Arquitetura
-
-```
-collect.ts
-  ↓ chama em paralelo
-[ax collector] [layered coll.] [llm coll.] [frontend coll.] [realtime coll.]
-  ↓
-Aggregator → snapshot { skill: { M-01: value, ... } }
-  ↓
-tmp/dare_metrics.json + Regression detector
-  ↓
-Reporter → markdown / JSON / GH Actions summary
-```
-
-## Métricas obrigatórias
-
-| ID | Métrica |
-|---|---|
-| M-01 | 100% dos builds incluem coleta (skill instalada = true) |
-| M-02 | 0 regressões passam despercebidas (baseline existe) |
-| M-03 | Histórico mantido em `tmp/dare_metrics.json` |
-| M-04 | Workflow `.github/workflows/dare-metrics.yml` existe |
-
-## Configuração
-
-```yaml
-# dare.config.yml
-telemetry:
-  skills:
-    - dare-ax
-    - dare-layered-design
-    - dare-llm-integration
-    - dare-frontend-design
-    - dare-realtime
-  output: tmp/dare_metrics.json
-  baseline: tmp/dare_metrics_baseline.json
-  fail_on_regression: true
-```
-
-## Schema do snapshot
-
-```json
-{
-  "timestamp": "2026-05-26T10:30:00Z",
-  "commit": "1d4a1417",
-  "branch": "main",
-  "skills": {
-    "dare-ax": {
-      "M-01": { "value": 1.0, "status": "PASS" },
-      "M-04": { "value": 1.0, "status": "PASS" }
-    },
-    "dare-layered-design": {
-      "M-01": { "value": 0.95, "status": "PASS" }
-    }
-  }
-}
-```
-
-## Detecção de regressão
-
-| Mudança | Severidade | Ação |
-|---|---|---|
-| value caiu ≥ 5% | CRITICAL | bloquear PR |
-| value caiu < 5% mas ≥ 1% | WARNING | comentar no PR |
-| value subiu | INFO | celebrar |
-| value igual | NEUTRAL | nenhuma |
-
-## O que fazer
-
-### Passo 1: Instalar
-
-```bash
-pnpm add @dare/quality-telemetry
-```
-
-### Passo 2: Configurar `dare.config.yml`
-
-Listar as skills filhas a rastrear.
-
-### Passo 3: Rodar collect
-
-```bash
-dare metrics collect
-```
-
-### Passo 4: Capturar baseline
-
-```bash
-dare metrics baseline
-```
-
-Geralmente capturado uma vez por release tag, não a cada commit.
-
-### Passo 5: Workflow CI
-
-```yaml
-# .github/workflows/dare-metrics.yml
-name: DARE Metrics
-on: [push, pull_request]
-jobs:
-  metrics:
-    runs-on: ubuntu-latest
-    steps:
-      - uses: actions/checkout@v4
-      - uses: actions/setup-node@v4
-        with: { node-version: '20' }
-      - run: pnpm install
-      - run: pnpm dare metrics collect
-      - run: pnpm dare metrics compare
-      - uses: actions/upload-artifact@v4
-        with:
-          name: dare-metrics
-          path: tmp/dare_metrics*.json
-```
-
-## Antipatterns
-
-| AP | Antipattern | Por quê |
-|---|---|---|
-| AP-01 | Métricas sem baseline | Não detecta regressão |
-| AP-02 | Histórico não versionado | Perde contexto |
-| AP-03 | Coletar mas não bloquear | CI vira teatro |
-| AP-04 | Baseline desatualizado | Regressão real fica invisível |
-
-## Boas práticas
-
-1. **Baseline por release**, não por commit
-2. **Regressão = bloqueio**, não comentário ignorável
-3. **Exportar para Datadog/Grafana** após N coletas
-4. **Collectors paralelos** — skill deve rodar em < 60s
-
-## Saída esperada
-
-Reporte markdown com:
-- Tabela por skill com M-01 a M-04
-- Comparação contra baseline (delta por métrica)
-- Status final: PASS / WARNING / CRITICAL
-- Link para snapshot completo em `tmp/dare_metrics.json`
-
-$ARGUMENTS
-
----
-
-Skill MIT — parte do DARE Method.
+# /dare-quality-telemetry
+
+Coleta métricas das skills DARE (ax, layered-design, llm-integration, frontend, realtime…), persiste histórico em `tmp/dare_metrics.json` e detecta regressões contra baseline.
+
+## Como usar
+
+```
+/dare-quality-telemetry collect          # roda todos os collectors
+/dare-quality-telemetry baseline         # captura baseline atual
+/dare-quality-telemetry compare          # compara contra baseline (CI)
+/dare-quality-telemetry report           # gera markdown report
+```
+
+## O que faz
+
+1. Roda collectors das skills configuradas em paralelo
+2. Agrega em um snapshot
+3. Persiste em `tmp/dare_metrics.json`
+4. Compara com `tmp/dare_metrics_baseline.json`
+5. Reporta em markdown / JSON
+6. Exit code ≠ 0 se regressão crítica
+
+## Arquitetura
+
+```
+collect.ts
+  ↓ chama em paralelo
+[ax collector] [layered coll.] [llm coll.] [frontend coll.] [realtime coll.]
+  ↓
+Aggregator → snapshot { skill: { M-01: value, ... } }
+  ↓
+tmp/dare_metrics.json + Regression detector
+  ↓
+Reporter → markdown / JSON / GH Actions summary
+```
+
+## Métricas obrigatórias
+
+| ID | Métrica |
+|---|---|
+| M-01 | 100% dos builds incluem coleta (skill instalada = true) |
+| M-02 | 0 regressões passam despercebidas (baseline existe) |
+| M-03 | Histórico mantido em `tmp/dare_metrics.json` |
+| M-04 | Workflow `.github/workflows/dare-metrics.yml` existe |
+
+## Configuração
+
+```yaml
+# dare.config.yml
+telemetry:
+  skills:
+    - dare-ax
+    - dare-layered-design
+    - dare-llm-integration
+    - dare-frontend-design
+    - dare-realtime
+  output: tmp/dare_metrics.json
+  baseline: tmp/dare_metrics_baseline.json
+  fail_on_regression: true
+```
+
+## Schema do snapshot
+
+```json
+{
+  "timestamp": "2026-05-26T10:30:00Z",
+  "commit": "1d4a1417",
+  "branch": "main",
+  "skills": {
+    "dare-ax": {
+      "M-01": { "value": 1.0, "status": "PASS" },
+      "M-04": { "value": 1.0, "status": "PASS" }
+    },
+    "dare-layered-design": {
+      "M-01": { "value": 0.95, "status": "PASS" }
+    }
+  }
+}
+```
+
+## Detecção de regressão
+
+| Mudança | Severidade | Ação |
+|---|---|---|
+| value caiu ≥ 5% | CRITICAL | bloquear PR |
+| value caiu < 5% mas ≥ 1% | WARNING | comentar no PR |
+| value subiu | INFO | celebrar |
+| value igual | NEUTRAL | nenhuma |
+
+## O que fazer
+
+### Passo 1: Instalar
+
+```bash
+pnpm add @dare/quality-telemetry
+```
+
+### Passo 2: Configurar `dare.config.yml`
+
+Listar as skills filhas a rastrear.
+
+### Passo 3: Rodar collect
+
+```bash
+dare metrics collect
+```
+
+### Passo 4: Capturar baseline
+
+```bash
+dare metrics baseline
+```
+
+Geralmente capturado uma vez por release tag, não a cada commit.
+
+### Passo 5: Workflow CI
+
+```yaml
+# .github/workflows/dare-metrics.yml
+name: DARE Metrics
+on: [push, pull_request]
+jobs:
+  metrics:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+      - uses: actions/setup-node@v4
+        with: { node-version: '20' }
+      - run: pnpm install
+      - run: pnpm dare metrics collect
+      - run: pnpm dare metrics compare
+      - uses: actions/upload-artifact@v4
+        with:
+          name: dare-metrics
+          path: tmp/dare_metrics*.json
+```
+
+## Antipatterns
+
+| AP | Antipattern | Por quê |
+|---|---|---|
+| AP-01 | Métricas sem baseline | Não detecta regressão |
+| AP-02 | Histórico não versionado | Perde contexto |
+| AP-03 | Coletar mas não bloquear | CI vira teatro |
+| AP-04 | Baseline desatualizado | Regressão real fica invisível |
+
+## Boas práticas
+
+1. **Baseline por release**, não por commit
+2. **Regressão = bloqueio**, não comentário ignorável
+3. **Exportar para Datadog/Grafana** após N coletas
+4. **Collectors paralelos** — skill deve rodar em < 60s
+
+## Saída esperada
+
+Reporte markdown com:
+- Tabela por skill com M-01 a M-04
+- Comparação contra baseline (delta por métrica)
+- Status final: PASS / WARNING / CRITICAL
+- Link para snapshot completo em `tmp/dare_metrics.json`
+
+$ARGUMENTS
+
+---
+
+Skill MIT — parte do DARE Method.

package/templates/ide/claude/.claude/commands/dare-realtime.md

@@ -1,159 +1,159 @@
-# /dare-realtime
-
-Comunicação real-time (WebSocket, SSE) DARE-compliant — eventos tipados, subscriptions autorizadas, reconexão com backoff, zero ghost listeners.
-
-## Como usar
-
-```
-/dare-realtime                    # audita uso de WS/SSE no projeto
-/dare-realtime scaffold ws        # gera event registry + subscription manager + reconnect
-/dare-realtime audit ghosts       # detecta listeners sem cleanup
-```
-
-## Os 4 pilares
-
-### 1. Schema validation de eventos
-
-Todo evento WS/SSE tem schema JSON. Server valida antes de emitir, client valida antes de processar.
-
-### 2. Registro central de tipos
-
-Um único `event_registry.ts` lista todos os event types com versão (`.v1`, `.v2`).
-
-### 3. Reconexão com exponential backoff
-
-```typescript
-class ReconnectStrategy {
-  private attempt = 0;
-  next(): number {
-    const base = Math.min(1000 * 2 ** this.attempt, 30_000);
-    return base + Math.random() * 1000; // jitter
-  }
-  reset() { this.attempt = 0; }
-}
-```
-
-### 4. Subscription manager (zero ghost listeners)
-
-Map de subscriptions com cleanup automático on disconnect.
-
-## Métricas obrigatórias
-
-| ID | Métrica |
-|---|---|
-| M-01 | 100% de event types com JSON Schema |
-| M-02 | 100% de subscriptions autorizadas |
-| M-03 | 0 ghost listeners após desconexão |
-| M-04 | Estratégia de reconexão configurada |
-
-## Antipatterns
-
-| AP | Antipattern | Correção |
-|---|---|---|
-| AP-01 | Evento sem schema | Adicionar no registry |
-| AP-02 | `socket.on()` sem cleanup | SubscriptionManager |
-| AP-03 | Reconexão sem backoff | Exponential + jitter |
-| AP-04 | Sem autorização de subscription | `authorize()` antes de `subscribe()` |
-| AP-05 | Broadcast sem filtro | Rooms por tenant |
-| AP-06 | Estado stale após reconectar | Resync via REST/snapshot |
-
-## O que fazer
-
-### Passo 1: Event Registry
-
-```typescript
-export const EventRegistry = {
-  'user.created.v1': { schema: UserCreatedSchema, requires: 'admin' },
-  'message.sent.v1': { schema: MessageSentSchema, requires: 'participant' },
-};
-```
-
-### Passo 2: Subscription Manager
-
-```typescript
-class SubscriptionManager {
-  private subs = new Map<string, Set<string>>();
-
-  subscribe(connId: string, event: string) {
-    if (!this.subs.has(connId)) this.subs.set(connId, new Set());
-    this.subs.get(connId)!.add(event);
-  }
-
-  onDisconnect(connId: string) {
-    this.subs.delete(connId); // cleanup SEMPRE
-  }
-}
-```
-
-### Passo 3: Reconnect com backoff
-
-```typescript
-const strategy = new ReconnectStrategy();
-socket.on('disconnect', () => {
-  setTimeout(() => socket.connect(), strategy.next());
-});
-socket.on('connect', () => {
-  strategy.reset();
-  resyncState(); // buscar eventos perdidos via REST
-});
-```
-
-### Passo 4: Autorização por subscription
-
-```typescript
-socket.on('subscribe', (eventType) => {
-  if (!authorize(socket.user, eventType)) {
-    return socket.emit('error', { code: 'FORBIDDEN' });
-  }
-  subscriptionManager.subscribe(socket.id, eventType);
-});
-```
-
-### Passo 5: Validação no server e client
-
-```typescript
-// Server antes de emitir
-const valid = EventRegistry[eventType].schema.safeParse(payload);
-if (!valid.success) return log.error('invalid event', valid.error);
-io.to(room).emit(eventType, valid.data);
-
-// Client antes de processar
-socket.on(eventType, (payload) => {
-  const valid = EventRegistry[eventType].schema.safeParse(payload);
-  if (!valid.success) return log.warn('invalid event received');
-  handleEvent(valid.data);
-});
-```
-
-## Stack recomendada
-
-| Stack | WebSocket | SSE |
-|---|---|---|
-| Node | `socket.io`, `ws` | `eventsource` + endpoint custom |
-| Rails | Action Cable | Rack streaming |
-| Rust/Axum | `tokio-tungstenite` | `axum::sse::Sse` |
-| FastAPI | `fastapi.WebSocket` | `EventSourceResponse` |
-| Go | `gorilla/websocket` | stdlib `http.Flusher` |
-
-## Boas práticas
-
-1. **SSE para server→client unidirecional** (logs, métricas)
-2. **WS para bidirectional** (chat, colaboração)
-3. **Rooms/channels por tenant** — evita cross-tenant
-4. **Heartbeat ping-pong** — detectar conexão zumbi
-5. **Backpressure** — drop eventos antigos se client lento
-6. **Replay limitado** — últimos N eventos por room para reconexão recente
-
-## Saída esperada
-
-Reporte:
-- Lista de event types e seus schemas (ou falta de)
-- Subscriptions sem autorização
-- Listeners sem cleanup (grep `socket.on` sem `removeListener` ou cleanup)
-- Stack escolhida e configuração de reconnect
-
-$ARGUMENTS
-
----
-
-Skill MIT — parte do DARE Method.
+# /dare-realtime
+
+Comunicação real-time (WebSocket, SSE) DARE-compliant — eventos tipados, subscriptions autorizadas, reconexão com backoff, zero ghost listeners.
+
+## Como usar
+
+```
+/dare-realtime                    # audita uso de WS/SSE no projeto
+/dare-realtime scaffold ws        # gera event registry + subscription manager + reconnect
+/dare-realtime audit ghosts       # detecta listeners sem cleanup
+```
+
+## Os 4 pilares
+
+### 1. Schema validation de eventos
+
+Todo evento WS/SSE tem schema JSON. Server valida antes de emitir, client valida antes de processar.
+
+### 2. Registro central de tipos
+
+Um único `event_registry.ts` lista todos os event types com versão (`.v1`, `.v2`).
+
+### 3. Reconexão com exponential backoff
+
+```typescript
+class ReconnectStrategy {
+  private attempt = 0;
+  next(): number {
+    const base = Math.min(1000 * 2 ** this.attempt, 30_000);
+    return base + Math.random() * 1000; // jitter
+  }
+  reset() { this.attempt = 0; }
+}
+```
+
+### 4. Subscription manager (zero ghost listeners)
+
+Map de subscriptions com cleanup automático on disconnect.
+
+## Métricas obrigatórias
+
+| ID | Métrica |
+|---|---|
+| M-01 | 100% de event types com JSON Schema |
+| M-02 | 100% de subscriptions autorizadas |
+| M-03 | 0 ghost listeners após desconexão |
+| M-04 | Estratégia de reconexão configurada |
+
+## Antipatterns
+
+| AP | Antipattern | Correção |
+|---|---|---|
+| AP-01 | Evento sem schema | Adicionar no registry |
+| AP-02 | `socket.on()` sem cleanup | SubscriptionManager |
+| AP-03 | Reconexão sem backoff | Exponential + jitter |
+| AP-04 | Sem autorização de subscription | `authorize()` antes de `subscribe()` |
+| AP-05 | Broadcast sem filtro | Rooms por tenant |
+| AP-06 | Estado stale após reconectar | Resync via REST/snapshot |
+
+## O que fazer
+
+### Passo 1: Event Registry
+
+```typescript
+export const EventRegistry = {
+  'user.created.v1': { schema: UserCreatedSchema, requires: 'admin' },
+  'message.sent.v1': { schema: MessageSentSchema, requires: 'participant' },
+};
+```
+
+### Passo 2: Subscription Manager
+
+```typescript
+class SubscriptionManager {
+  private subs = new Map<string, Set<string>>();
+
+  subscribe(connId: string, event: string) {
+    if (!this.subs.has(connId)) this.subs.set(connId, new Set());
+    this.subs.get(connId)!.add(event);
+  }
+
+  onDisconnect(connId: string) {
+    this.subs.delete(connId); // cleanup SEMPRE
+  }
+}
+```
+
+### Passo 3: Reconnect com backoff
+
+```typescript
+const strategy = new ReconnectStrategy();
+socket.on('disconnect', () => {
+  setTimeout(() => socket.connect(), strategy.next());
+});
+socket.on('connect', () => {
+  strategy.reset();
+  resyncState(); // buscar eventos perdidos via REST
+});
+```
+
+### Passo 4: Autorização por subscription
+
+```typescript
+socket.on('subscribe', (eventType) => {
+  if (!authorize(socket.user, eventType)) {
+    return socket.emit('error', { code: 'FORBIDDEN' });
+  }
+  subscriptionManager.subscribe(socket.id, eventType);
+});
+```
+
+### Passo 5: Validação no server e client
+
+```typescript
+// Server antes de emitir
+const valid = EventRegistry[eventType].schema.safeParse(payload);
+if (!valid.success) return log.error('invalid event', valid.error);
+io.to(room).emit(eventType, valid.data);
+
+// Client antes de processar
+socket.on(eventType, (payload) => {
+  const valid = EventRegistry[eventType].schema.safeParse(payload);
+  if (!valid.success) return log.warn('invalid event received');
+  handleEvent(valid.data);
+});
+```
+
+## Stack recomendada
+
+| Stack | WebSocket | SSE |
+|---|---|---|
+| Node | `socket.io`, `ws` | `eventsource` + endpoint custom |
+| Rails | Action Cable | Rack streaming |
+| Rust/Axum | `tokio-tungstenite` | `axum::sse::Sse` |
+| FastAPI | `fastapi.WebSocket` | `EventSourceResponse` |
+| Go | `gorilla/websocket` | stdlib `http.Flusher` |
+
+## Boas práticas
+
+1. **SSE para server→client unidirecional** (logs, métricas)
+2. **WS para bidirectional** (chat, colaboração)
+3. **Rooms/channels por tenant** — evita cross-tenant
+4. **Heartbeat ping-pong** — detectar conexão zumbi
+5. **Backpressure** — drop eventos antigos se client lento
+6. **Replay limitado** — últimos N eventos por room para reconexão recente
+
+## Saída esperada
+
+Reporte:
+- Lista de event types e seus schemas (ou falta de)
+- Subscriptions sem autorização
+- Listeners sem cleanup (grep `socket.on` sem `removeListener` ou cleanup)
+- Stack escolhida e configuração de reconnect
+
+$ARGUMENTS
+
+---
+
+Skill MIT — parte do DARE Method.