@spec-wave/cli 0.1.0 → 0.2.0

package/bin/spec-wave.mjs

@@ -22,6 +22,8 @@ program
   .option('--skip-project', 'Pula a criação do GitHub Project (use se já foi criado)')
   .option('--skip-labels', 'Pula a criação das labels')
   .option('--skip-files', 'Pula a criação dos arquivos de workflow')
+  .option('--provider <provider>', 'Provider de IA dos workflows: anthropic ou openrouter')
+  .option('--model <model>', 'Modelo de IA usado pelos workflows (ex.: anthropic/claude-3.7-sonnet)')
   .action(async (options) => {
     const { init } = await import('../src/commands/init.mjs');
     await init(options);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@spec-wave/cli",
-  "version": "0.1.0",
+  "version": "0.2.0",
   "description": "Setup spec-driven GitHub workflow with Projects v2, labels, issue templates, and AI-powered Actions",
   "type": "module",
   "bin": {

package/src/commands/info.mjs

@@ -45,6 +45,7 @@ export async function info(options = {}) {
     `${chalk.dim('Repositório:')} ${config.owner ?? '?'}/${config.repo ?? '?'}\n` +
     `${chalk.dim('Project:')}     ${config.project?.title ?? '—'}\n` +
     `${chalk.dim('URL:')}         ${config.project?.url ? chalk.cyan(config.project.url) : '—'}\n` +
+    `${chalk.dim('IA:')}          ${config.ai ? `${config.ai.provider} · ${config.ai.model}` : '—'}\n` +
     `${chalk.dim('Versão CLI:')}  ${config.version ?? '?'}\n` +
     `${chalk.dim('Criado em:')}   ${config.initializedAt ?? '?'}`,
     'Configuração'

package/src/commands/init.mjs

@@ -9,7 +9,7 @@ import { setupProject } from '../setup/project.mjs';
 import { setupLabels } from '../setup/labels.mjs';
 import { setupFiles } from '../setup/files.mjs';
 import { upsertFile } from '../api/github-rest.mjs';
-import { CONFIG_FILE } from '../config.mjs';
+import { CONFIG_FILE, AI_PROVIDERS, getProvider, DEFAULT_PROVIDER } from '../config.mjs';
 
 const __dir = path.dirname(fileURLToPath(import.meta.url));
 const pkg = JSON.parse(readFileSync(path.join(__dir, '..', '..', 'package.json'), 'utf-8'));
@@ -51,7 +51,7 @@ export async function init(options) {
   }
 
   // --- Wizard ou flags ---
-  let owner, repo, projectTitle;
+  let owner, repo, projectTitle, provider, model;
   if (options.repo) {
     if (!options.repo.includes('/')) {
       p.log.error('Formato inválido para --repo. Use: owner/repo');
@@ -59,16 +59,28 @@ export async function init(options) {
     }
     [owner, repo] = options.repo.split('/');
     projectTitle = options.projectTitle ?? `${repo} — Spec Wave`;
+    provider = (options.provider ?? DEFAULT_PROVIDER).toLowerCase();
+    if (!getProvider(provider)) {
+      p.log.error(
+        `Provider inválido: ${provider}. Use um de: ${AI_PROVIDERS.map(pr => pr.value).join(', ')}`
+      );
+      process.exit(1);
+    }
+    model = options.model ?? getProvider(provider).defaultModel;
     p.log.info(`Repositório: ${owner}/${repo}`);
     p.log.info(`Projeto: ${projectTitle}`);
+    p.log.info(`IA: ${getProvider(provider).label} · modelo ${model}`);
   } else {
-    ({ owner, repo, projectTitle } = await runWizard());
+    ({ owner, repo, projectTitle, provider, model } = await runWizard());
   }
 
+  const providerMeta = getProvider(provider);
+
   if (options.dryRun) {
     p.log.info(chalk.yellow('Modo dry-run: nenhuma alteração será feita.'));
     p.log.info(`  Repositório: ${owner}/${repo}`);
     p.log.info(`  Projeto: ${projectTitle}`);
+    p.log.info(`  IA: ${providerMeta.label} · modelo ${model}`);
     p.log.info('  Fases: project board → labels → workflow files');
     p.outro('Dry-run concluído.');
     return;
@@ -153,6 +165,10 @@ export async function init(options) {
         number: projectNumber ?? null,
         fields: projectFields ?? null,
       },
+      ai: {
+        provider: providerMeta.value,
+        model,
+      },
       initializedAt: new Date().toISOString(),
     };
     await upsertFile(
@@ -182,7 +198,7 @@ export async function init(options) {
     `\n${chalk.green('✓')} spec-wave configurado com sucesso!\n\n` +
     (projectUrl ? `  Projeto: ${chalk.cyan(projectUrl)}\n\n` : '') +
     `  Próximos passos:\n` +
-    `  1. Adicione ANTHROPIC_API_KEY como secret no repositório\n` +
+    `  1. Adicione ${providerMeta.secret} como secret no repositório (provider: ${providerMeta.label})\n` +
     `  2. Configure o board view para agrupar por "Etapa"\n` +
     `  3. Crie uma Feature com o prefixo [FEATURE] no título\n` +
     `  4. Use a skill spec-wave para guiar o fluxo\n\n` +

package/src/config.mjs

@@ -4,6 +4,35 @@
 // pelo comando `info` (e pela skill) para detectar se o spec-wave já foi configurado.
 export const CONFIG_FILE = '.spec-wave.json';
 
+// Providers de IA suportados pelos workflows (generate-plan/spec/decompose).
+// O provider e o modelo escolhidos no `init` são persistidos em .spec-wave.json
+// (bloco `ai`) e lidos em runtime por src/lib/claude.mjs. Cada provider declara
+// o secret do GitHub Actions de onde a chave é lida.
+export const AI_PROVIDERS = [
+  {
+    value: 'anthropic',
+    label: 'Anthropic (API direta)',
+    hint: 'Usa o secret ANTHROPIC_API_KEY',
+    secret: 'ANTHROPIC_API_KEY',
+    defaultModel: 'claude-sonnet-4-6',
+    modelHint: 'ex.: claude-sonnet-4-6, claude-opus-4-1',
+  },
+  {
+    value: 'openrouter',
+    label: 'OpenRouter (multi-modelo)',
+    hint: 'Usa o secret OPENROUTER_API_KEY',
+    secret: 'OPENROUTER_API_KEY',
+    defaultModel: 'anthropic/claude-3.7-sonnet',
+    modelHint: 'ex.: anthropic/claude-3.7-sonnet, openai/gpt-4o — veja openrouter.ai/models',
+  },
+];
+
+export const DEFAULT_PROVIDER = 'anthropic';
+
+export function getProvider(value) {
+  return AI_PROVIDERS.find(p => p.value === value);
+}
+
 export const STATUS_OPTIONS = [
   { name: '📥 Backlog',          color: 'GRAY'   },
   { name: '🎯 Priorizado',       color: 'BLUE'   },

package/src/lib/claude.mjs

@@ -1,8 +1,39 @@
 import Anthropic from '@anthropic-ai/sdk';
+import { readFileSync, existsSync } from 'node:fs';
+import path from 'node:path';
+import { CONFIG_FILE, getProvider, DEFAULT_PROVIDER } from '../config.mjs';
 
-const DEFAULT_MODEL = 'claude-sonnet-4-6';
+// Resolve o provider/modelo de IA a partir do .spec-wave.json (gravado pelo init
+// e versionado no repo) com precedência para variáveis de ambiente — assim os
+// workflows usam exatamente o que foi escolhido no init, sem depender de flags.
+function resolveAi() {
+  let fileAi = {};
+  try {
+    const configPath = path.join(process.cwd(), CONFIG_FILE);
+    if (existsSync(configPath)) {
+      fileAi = JSON.parse(readFileSync(configPath, 'utf-8')).ai || {};
+    }
+  } catch {
+    // config ausente/corrompido → cai nos defaults/env
+  }
+
+  const provider = (process.env.SPEC_WAVE_PROVIDER || fileAi.provider || DEFAULT_PROVIDER).toLowerCase();
+  const meta = getProvider(provider) || getProvider(DEFAULT_PROVIDER);
+  const model = process.env.SPEC_WAVE_MODEL || fileAi.model || meta.defaultModel;
+  return { provider: meta.value, model, secret: meta.secret };
+}
 
 export async function generateDocument(systemPrompt, userContent) {
+  const ai = resolveAi();
+  console.log(`Provider de IA: ${ai.provider} · modelo: ${ai.model}`);
+
+  if (ai.provider === 'openrouter') {
+    return generateWithOpenRouter(systemPrompt, userContent, ai);
+  }
+  return generateWithAnthropic(systemPrompt, userContent, ai);
+}
+
+async function generateWithAnthropic(systemPrompt, userContent, ai) {
   const apiKey = process.env.ANTHROPIC_API_KEY;
   if (!apiKey) {
     throw new Error(
@@ -12,10 +43,8 @@ export async function generateDocument(systemPrompt, userContent) {
   }
 
   const client = new Anthropic({ apiKey });
-  const model = process.env.ANTHROPIC_MODEL || DEFAULT_MODEL;
-
   const message = await client.messages.create({
-    model,
+    model: ai.model,
     max_tokens: 4096,
     messages: [{ role: 'user', content: userContent }],
     system: systemPrompt,
@@ -23,3 +52,43 @@ export async function generateDocument(systemPrompt, userContent) {
 
   return message.content[0].text;
 }
+
+async function generateWithOpenRouter(systemPrompt, userContent, ai) {
+  const apiKey = process.env.OPENROUTER_API_KEY;
+  if (!apiKey) {
+    throw new Error(
+      'OPENROUTER_API_KEY not set.\n' +
+      'Add it as a GitHub Actions secret or set it in your environment.'
+    );
+  }
+
+  const res = await fetch('https://openrouter.ai/api/v1/chat/completions', {
+    method: 'POST',
+    headers: {
+      Authorization: `Bearer ${apiKey}`,
+      'Content-Type': 'application/json',
+      'HTTP-Referer': 'https://github.com/moacsjr/spec-wave',
+      'X-Title': 'spec-wave',
+    },
+    body: JSON.stringify({
+      model: ai.model,
+      max_tokens: 4096,
+      messages: [
+        { role: 'system', content: systemPrompt },
+        { role: 'user', content: userContent },
+      ],
+    }),
+  });
+
+  if (!res.ok) {
+    const body = await res.text();
+    throw new Error(`OpenRouter API ${res.status}: ${body}`);
+  }
+
+  const data = await res.json();
+  const content = data?.choices?.[0]?.message?.content;
+  if (!content) {
+    throw new Error(`OpenRouter retornou resposta vazia: ${JSON.stringify(data)}`);
+  }
+  return content;
+}

package/src/templates/workflows/decompose.yml

@@ -26,4 +26,5 @@ jobs:
         env:
           GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
           ANTHROPIC_API_KEY: ${{ secrets.ANTHROPIC_API_KEY }}
+          OPENROUTER_API_KEY: ${{ secrets.OPENROUTER_API_KEY }}
           GITHUB_REPOSITORY: ${{ github.repository }}

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

@@ -28,4 +28,5 @@ jobs:
         env:
           GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
           ANTHROPIC_API_KEY: ${{ secrets.ANTHROPIC_API_KEY }}
+          OPENROUTER_API_KEY: ${{ secrets.OPENROUTER_API_KEY }}
           GITHUB_REPOSITORY: ${{ github.repository }}

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

@@ -28,4 +28,5 @@ jobs:
         env:
           GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
           ANTHROPIC_API_KEY: ${{ secrets.ANTHROPIC_API_KEY }}
+          OPENROUTER_API_KEY: ${{ secrets.OPENROUTER_API_KEY }}
           GITHUB_REPOSITORY: ${{ github.repository }}

package/src/ui/wizard.mjs

@@ -1,5 +1,6 @@
 import * as p from '@clack/prompts';
 import { execSync } from 'node:child_process';
+import { AI_PROVIDERS, getProvider, DEFAULT_PROVIDER } from '../config.mjs';
 
 export async function runWizard() {
   p.intro('spec-wave — configuração do fluxo spec-driven');
@@ -23,6 +24,25 @@ export async function runWizard() {
           placeholder: 'Meu Projeto — Spec Wave',
         }),
 
+      provider: () =>
+        p.select({
+          message: 'Qual provider de IA os workflows devem usar?',
+          options: AI_PROVIDERS.map(pr => ({ value: pr.value, label: pr.label, hint: pr.hint })),
+          initialValue: DEFAULT_PROVIDER,
+        }),
+
+      model: ({ results }) => {
+        const pr = getProvider(results.provider);
+        return p.text({
+          message: `Qual modelo de IA os workflows devem usar? (${pr.modelHint})`,
+          defaultValue: pr.defaultModel,
+          placeholder: pr.defaultModel,
+          validate: v => {
+            if (!v || !v.trim()) return 'Informe o modelo a ser usado.';
+          },
+        });
+      },
+
       triggerStrategy: () =>
         p.select({
           message: 'Como prefere acionar os workflows automáticos?',
@@ -67,7 +87,13 @@ export async function runWizard() {
   }
 
   const [owner, repo] = answers.repo.split('/');
-  return { owner, repo, projectTitle: answers.projectTitle };
+  return {
+    owner,
+    repo,
+    projectTitle: answers.projectTitle,
+    provider: answers.provider,
+    model: answers.model.trim(),
+  };
 }
 
 function detectRepo() {