@spec-wave/cli 0.1.0

package/src/templates/issue/spec-template.md

@@ -0,0 +1,32 @@
+---
+name: "Especificação Funcional (spec.md)"
+about: "Especificação funcional de uma Feature. Gerado automaticamente ao mover para a coluna 📋 Spec."
+title: "[FEATURE] "
+labels: "[FEATURE]"
+assignees: ""
+---
+
+# Objetivo
+
+<!-- O que esta Feature entrega e qual problema resolve? -->
+
+# Regras de Negócio
+
+<!-- Liste as regras que governam o comportamento desta Feature -->
+
+# Fluxos
+
+<!-- Descreva o fluxo principal e os fluxos alternativos -->
+
+# Critérios de Aceite
+
+- [ ] 
+- [ ] 
+
+# Casos de Erro
+
+<!-- O que acontece quando algo dá errado? Como o sistema se comporta? -->
+
+# Dependências
+
+<!-- Outras Features, integrações, APIs externas ou pré-requisitos -->

package/src/templates/workflows/decompose.yml

@@ -0,0 +1,29 @@
+name: Decompose Feature
+
+on:
+  issues:
+    types: [labeled]
+
+jobs:
+  decompose:
+    if: >
+      github.event.label.name == 'spec-wave:decompose' &&
+      contains(github.event.issue.title, '[FEATURE]')
+    runs-on: ubuntu-latest
+    permissions:
+      issues: write
+      contents: read
+
+    steps:
+      - uses: actions/checkout@v4
+
+      - uses: actions/setup-node@v4
+        with:
+          node-version: '20'
+
+      - name: Decompose into Stories and Tasks
+        run: npx @spec-wave/cli decompose --issue-number ${{ github.event.issue.number }}
+        env:
+          GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
+          ANTHROPIC_API_KEY: ${{ secrets.ANTHROPIC_API_KEY }}
+          GITHUB_REPOSITORY: ${{ github.repository }}

package/src/templates/workflows/generate-plan.yml

@@ -0,0 +1,31 @@
+name: Generate Plan
+
+on:
+  issues:
+    types: [labeled]
+
+jobs:
+  generate-plan:
+    if: >
+      github.event.label.name == 'spec-wave:plan' &&
+      contains(github.event.issue.title, '[FEATURE]')
+    runs-on: ubuntu-latest
+    permissions:
+      issues: write
+      contents: write
+
+    steps:
+      - uses: actions/checkout@v4
+        with:
+          token: ${{ secrets.GITHUB_TOKEN }}
+
+      - uses: actions/setup-node@v4
+        with:
+          node-version: '20'
+
+      - name: Generate plan.md
+        run: npx @spec-wave/cli generate-plan --issue-number ${{ github.event.issue.number }}
+        env:
+          GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
+          ANTHROPIC_API_KEY: ${{ secrets.ANTHROPIC_API_KEY }}
+          GITHUB_REPOSITORY: ${{ github.repository }}

package/src/templates/workflows/generate-spec.yml

@@ -0,0 +1,31 @@
+name: Generate Spec
+
+on:
+  issues:
+    types: [labeled]
+
+jobs:
+  generate-spec:
+    if: >
+      github.event.label.name == 'spec-wave:spec' &&
+      contains(github.event.issue.title, '[FEATURE]')
+    runs-on: ubuntu-latest
+    permissions:
+      issues: write
+      contents: write
+
+    steps:
+      - uses: actions/checkout@v4
+        with:
+          token: ${{ secrets.GITHUB_TOKEN }}
+
+      - uses: actions/setup-node@v4
+        with:
+          node-version: '20'
+
+      - name: Generate spec.md
+        run: npx @spec-wave/cli generate-spec --issue-number ${{ github.event.issue.number }}
+        env:
+          GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
+          ANTHROPIC_API_KEY: ${{ secrets.ANTHROPIC_API_KEY }}
+          GITHUB_REPOSITORY: ${{ github.repository }}

package/src/templates/workflows/validate.yml

@@ -0,0 +1,27 @@
+name: Validate Spec + Plan
+
+on:
+  issues:
+    types: [labeled]
+
+jobs:
+  validate:
+    if: >
+      github.event.label.name == 'spec-wave:ready' &&
+      contains(github.event.issue.title, '[FEATURE]')
+    runs-on: ubuntu-latest
+    permissions:
+      issues: write
+
+    steps:
+      - uses: actions/checkout@v4
+
+      - uses: actions/setup-node@v4
+        with:
+          node-version: '20'
+
+      - name: Validate spec and plan
+        run: npx @spec-wave/cli validate --issue-number ${{ github.event.issue.number }}
+        env:
+          GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
+          GITHUB_REPOSITORY: ${{ github.repository }}

package/src/ui/wizard.mjs

@@ -0,0 +1,83 @@
+import * as p from '@clack/prompts';
+import { execSync } from 'node:child_process';
+
+export async function runWizard() {
+  p.intro('spec-wave — configuração do fluxo spec-driven');
+
+  const answers = await p.group(
+    {
+      repo: () =>
+        p.text({
+          message: 'Repositório GitHub (owner/repo):',
+          placeholder: detectRepo(),
+          defaultValue: detectRepo(),
+          validate: v => {
+            if (!v || !v.includes('/')) return 'Formato esperado: owner/repo';
+          },
+        }),
+
+      projectTitle: ({ results }) =>
+        p.text({
+          message: 'Nome do GitHub Project:',
+          defaultValue: `${results.repo?.split('/')[1] ?? 'projeto'} — Spec Wave`,
+          placeholder: 'Meu Projeto — Spec Wave',
+        }),
+
+      triggerStrategy: () =>
+        p.select({
+          message: 'Como prefere acionar os workflows automáticos?',
+          options: [
+            {
+              value: 'labels',
+              label: 'Labels (recomendado)',
+              hint: 'A skill adiciona labels automaticamente ao mover cards',
+            },
+            {
+              value: 'webhook',
+              label: 'Webhook (em breve)',
+              hint: 'Acionamento automático ao mover card no board — requer endpoint externo',
+            },
+          ],
+        }),
+
+      confirm: ({ results }) =>
+        p.confirm({
+          message: `Configurar ${results.repo} com GitHub Project "${results.projectTitle}"?\n  - 12 colunas kanban\n  - 5 campos customizados\n  - 15 labels\n  - 4 workflows + 2 issue templates`,
+          initialValue: true,
+        }),
+    },
+    {
+      onCancel: () => {
+        p.cancel('Operação cancelada.');
+        process.exit(0);
+      },
+    }
+  );
+
+  if (!answers.confirm) {
+    p.cancel('Operação cancelada.');
+    process.exit(0);
+  }
+
+  if (answers.triggerStrategy === 'webhook') {
+    p.note(
+      'Webhook support está planejado para uma versão futura.\nUsando labels por enquanto.',
+      'Aviso'
+    );
+  }
+
+  const [owner, repo] = answers.repo.split('/');
+  return { owner, repo, projectTitle: answers.projectTitle };
+}
+
+function detectRepo() {
+  try {
+    const remote = execSync('git remote get-url origin', { stdio: ['pipe', 'pipe', 'pipe'] })
+      .toString()
+      .trim();
+    const match = remote.match(/github\.com[:/]([^/]+\/[^/.]+)/);
+    return match ? match[1] : '';
+  } catch {
+    return '';
+  }
+}