@guilhermefsousa/open-spec-kit 0.0.9 → 0.0.11

package/README.md

@@ -23,7 +23,7 @@ npx open-spec-kit update
 O workflow completo roda com 4 skills no VS Code:
 
 ```
-/setup → /discovery → /spec → /dev
+/osk-init → /osk-discover → /osk-spec → /osk-build
 ```
 
 Cada skill lê o que a anterior produziu, gera artefatos e atualiza o Confluence automaticamente.

package/bin/open-spec-kit.js

@@ -2,6 +2,7 @@
 
 import { Command } from 'commander';
 import { initCommand } from '../src/commands/init.js';
+import { installCommand } from '../src/commands/install.js';
 import { updateCommand } from '../src/commands/update.js';
 import { validateCommand } from '../src/commands/validate.js';
 import { doctorCommand } from '../src/commands/doctor.js';
@@ -18,6 +19,12 @@ program
   .description('Inicializar estrutura de spec-driven development no projeto')
   .action(initCommand);
 
+program
+  .command('install')
+  .description('Instalar skills e agents globalmente em ~/.open-spec-kit/')
+  .option('--force', 'Sobrescrever tudo, incluindo credenciais')
+  .action(installCommand);
+
 program
   .command('update')
   .description('Re-gerar arquivos de adapter quando skills ou agents mudarem')

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@guilhermefsousa/open-spec-kit",
-  "version": "0.0.9",
+  "version": "0.0.11",
   "description": "CLI para spec-driven development com suporte a Claude Code e GitHub Copilot",
   "type": "module",
   "bin": {

package/src/commands/doctor.js

@@ -5,6 +5,7 @@ import { execSync } from 'child_process';
 import yaml from 'yaml';
 import { detectMcpRunner, getInstallInstructions } from '../utils/mcp-detect.js';
 import { confluenceRequest, figmaRequest, isSslError } from '../utils/http.js';
+import { GLOBAL_DIR, getGlobalPath, getGlobalEnvPath, parseEnvContent } from '../utils/global-path.js';
 
 export async function doctorCommand() {
   console.log(chalk.bold('\n  open-spec-kit doctor\n'));
@@ -16,6 +17,28 @@ export async function doctorCommand() {
   let claudeMcpContent = '';
   let copilotMcpContent = '';
 
+  // Check 0: Global installation exists
+  try {
+    await access(GLOBAL_DIR);
+    await access(getGlobalEnvPath());
+    console.log(chalk.green(`  ✓ Instalação global encontrada (${GLOBAL_DIR})`));
+    pass++;
+  } catch {
+    console.log(chalk.red(`  ✗ Instalação global não encontrada (${GLOBAL_DIR})`));
+    console.log(chalk.dim('  Execute "open-spec-kit install" para instalar skills e credenciais.'));
+    fail++;
+  }
+
+  // Check 0b: Version check
+  try {
+    const versionJson = JSON.parse(await readFile(getGlobalPath('version.json'), 'utf-8'));
+    console.log(chalk.green(`  ✓ Versão instalada: ${versionJson.version}`));
+    pass++;
+  } catch {
+    console.log(chalk.yellow('  ⚠ version.json ausente — execute "open-spec-kit install" para atualizar'));
+    fail++;
+  }
+
   // Check 1: projects.yml exists and is filled
   try {
     projectsContent = await readFile(join(cwd, 'projects.yml'), 'utf-8');
@@ -32,25 +55,12 @@ export async function doctorCommand() {
     fail++;
   }
 
-  // Check 2: Agents configured
-  let agents = [];
+  // Check 2: Repos configured
   let projectsData = null;
   try {
     projectsData = yaml.parse(projectsContent);
-    agents = projectsData?.project?.agents || [];
-    if (!Array.isArray(agents)) agents = [];
-  } catch { /* fallback: ignore parse error, agents = [] */ }
-
-  if (agents.length > 0) {
-    console.log(chalk.green(`  ✓ AI tools configurados: ${agents.join(', ')}`));
-    pass++;
-  } else {
-    console.log(chalk.yellow('  ⚠ Nenhum AI tool configurado em projects.yml (campo agents:)'));
-
-    fail++;
-  }
+  } catch { /* ignore */ }
 
-  // Check 2b: Repos configured
   try {
     const repos = projectsData?.repos;
     const hasRepos = Array.isArray(repos) && repos.some(r => r && typeof r === 'object' && r.name);
@@ -63,131 +73,101 @@ export async function doctorCommand() {
     }
   } catch { /* ignore */ }
 
-  // Check 3: Claude Code files
-  if (agents.includes('claude')) {
-    try {
-      claudeMcpContent = await readFile(join(cwd, '.mcp.json'), 'utf-8');
-      if (claudeMcpContent.includes('SEU-TOKEN') || claudeMcpContent.includes('SEU-DOMINIO')
-          || claudeMcpContent.includes('seu-token-aqui') || claudeMcpContent.includes('seu-dominio')
-          || claudeMcpContent.includes('seu-email') || claudeMcpContent.includes('${CONFLUENCE_URL}')
-          || claudeMcpContent.includes('${CONFLUENCE_API_TOKEN}')) {
-        console.log(chalk.yellow('  ⚠ .mcp.json (Claude) existe mas tem placeholders'));
-        fail++;
-      } else {
-        console.log(chalk.green('  ✓ .mcp.json (Claude) configurado'));
-        pass++;
-      }
-    } catch {
-      console.log(chalk.red('  ✗ .mcp.json (Claude) nao encontrado'));
+  // Check 3: MCP configs (still per-project)
+  try {
+    claudeMcpContent = await readFile(join(cwd, '.mcp.json'), 'utf-8');
+    if (claudeMcpContent.includes('SEU-TOKEN') || claudeMcpContent.includes('seu-token-aqui')
+        || claudeMcpContent.includes('seu-dominio') || claudeMcpContent.includes('${CONFLUENCE_URL}')) {
+      console.log(chalk.yellow('  ⚠ .mcp.json (Claude) existe mas tem placeholders'));
       fail++;
-    }
-
-    try {
-      await access(join(cwd, '.agents/agents/spec-hub.agent.md'));
-      console.log(chalk.green('  ✓ .agents/agents/spec-hub.agent.md existe'));
+    } else {
+      console.log(chalk.green('  ✓ .mcp.json (Claude) configurado'));
       pass++;
-    } catch {
-      console.log(chalk.red('  ✗ .agents/agents/spec-hub.agent.md ausente'));
-      fail++;
     }
+  } catch {
+    console.log(chalk.yellow('  ⚠ .mcp.json (Claude) não encontrado'));
+    fail++;
   }
 
-  // Check 4: Copilot files
-  if (agents.includes('copilot')) {
-    try {
-      copilotMcpContent = await readFile(join(cwd, '.vscode/mcp.json'), 'utf-8');
-      if (copilotMcpContent.includes('SEU-TOKEN') || copilotMcpContent.includes('SEU-DOMINIO')
-          || copilotMcpContent.includes('seu-token-aqui') || copilotMcpContent.includes('seu-dominio')
-          || copilotMcpContent.includes('seu-email') || copilotMcpContent.includes('${CONFLUENCE_URL}')
-          || copilotMcpContent.includes('${CONFLUENCE_API_TOKEN}')) {
-        console.log(chalk.yellow('  ⚠ .vscode/mcp.json (Copilot) existe mas tem placeholders'));
-        fail++;
-      } else {
-        console.log(chalk.green('  ✓ .vscode/mcp.json (Copilot) configurado'));
-        pass++;
-      }
-    } catch {
-      console.log(chalk.red('  ✗ .vscode/mcp.json (Copilot) ausente'));
+  try {
+    copilotMcpContent = await readFile(join(cwd, '.vscode/mcp.json'), 'utf-8');
+    if (copilotMcpContent.includes('SEU-TOKEN') || copilotMcpContent.includes('seu-token-aqui')
+        || copilotMcpContent.includes('seu-dominio') || copilotMcpContent.includes('${CONFLUENCE_URL}')) {
+      console.log(chalk.yellow('  ⚠ .vscode/mcp.json (Copilot) existe mas tem placeholders'));
       fail++;
-    }
-
-    try {
-      await access(join(cwd, '.github/agents/spec-hub.agent.md'));
-      console.log(chalk.green('  ✓ .github/agents/spec-hub.agent.md existe'));
+    } else {
+      console.log(chalk.green('  ✓ .vscode/mcp.json (Copilot) configurado'));
       pass++;
-    } catch {
-      console.log(chalk.red('  ✗ .github/agents/spec-hub.agent.md ausente'));
-      fail++;
-    }
-
-    try {
-      await access(join(cwd, '.github/copilot-instructions.md'));
-      console.log(chalk.green('  ✓ .github/copilot-instructions.md existe'));
-      pass++;
-    } catch {
-      console.log(chalk.red('  ✗ .github/copilot-instructions.md ausente'));
-      fail++;
     }
+  } catch {
+    console.log(chalk.yellow('  ⚠ .vscode/mcp.json (Copilot) não encontrado'));
+    fail++;
   }
 
-  // Check 5: Skills exist
+  // Check 4: Global skills exist
   const skills = [
-    '.agents/skills/setup-project/SKILL.md',
-    '.agents/skills/discovery/SKILL.md',
-    '.agents/skills/specifying-features/SKILL.md',
-    '.agents/skills/dev-orchestrator/SKILL.md',
+    'skills/setup-project/SKILL.md',
+    'skills/discovery/SKILL.md',
+    'skills/specifying-features/SKILL.md',
+    'skills/dev-orchestrator/SKILL.md',
   ];
-  let skillCount = 0;
-  for (const skill of skills) {
-    try {
-      await access(join(cwd, skill));
-      skillCount++;
-    } catch { /* missing */ }
-  }
+  const skillResults = await Promise.all(skills.map(s => access(getGlobalPath(s)).then(() => true, () => false)));
+  const skillCount = skillResults.filter(Boolean).length;
   if (skillCount === skills.length) {
-    console.log(chalk.green(`  ✓ ${skillCount}/4 skills encontrados`));
+    console.log(chalk.green(`  ✓ ${skillCount}/4 skills globais encontrados`));
     pass++;
   } else {
-    console.log(chalk.yellow(`  ⚠ ${skillCount}/4 skills encontrados`));
+    console.log(chalk.yellow(`  ⚠ ${skillCount}/4 skills globais encontrados`));
     fail++;
   }
 
-  // Check 6: Rules exist
-  const rules = [
-    '.agents/rules/ownership.instructions.md',
-    '.agents/rules/hub_structure.instructions.md',
-  ];
-  let ruleCount = 0;
-  for (const rule of rules) {
-    try {
-      await access(join(cwd, rule));
-      ruleCount++;
-    } catch { /* missing */ }
-  }
+  // Check 5: Global rules exist
+  const rules = ['rules/ownership.instructions.md', 'rules/hub_structure.instructions.md'];
+  const ruleResults = await Promise.all(rules.map(r => access(getGlobalPath(r)).then(() => true, () => false)));
+  const ruleCount = ruleResults.filter(Boolean).length;
   if (ruleCount === rules.length) {
-    console.log(chalk.green(`  ✓ ${ruleCount}/2 rules encontradas`));
+    console.log(chalk.green(`  ✓ ${ruleCount}/2 rules globais encontradas`));
     pass++;
   } else {
-    console.log(chalk.yellow(`  ⚠ ${ruleCount}/2 rules encontradas`));
+    console.log(chalk.yellow(`  ⚠ ${ruleCount}/2 rules globais encontradas`));
     fail++;
   }
 
-  // Check 7: MCP CLI available — detect best runner (direct, uvx, pipx)
+  // Check 6: Global agent hub
+  try {
+    await access(getGlobalPath('agents', 'spec-hub.agent.md'));
+    console.log(chalk.green('  ✓ spec-hub.agent.md global encontrado'));
+    pass++;
+  } catch {
+    console.log(chalk.yellow('  ⚠ spec-hub.agent.md global ausente'));
+    fail++;
+  }
+
+  // Check 7: Copilot global files
+  try {
+    await access(getGlobalPath('github', 'agents', 'spec-hub.agent.md'));
+    console.log(chalk.green('  ✓ Copilot agents globais encontrados'));
+    pass++;
+  } catch {
+    console.log(chalk.yellow('  ⚠ Copilot agents globais ausentes'));
+    fail++;
+  }
+
+  // Check 8: MCP CLI available
   const mcpRunner = detectMcpRunner();
   if (mcpRunner.method !== 'pip-fallback') {
     const via = mcpRunner.method === 'direct' ? 'PATH' : mcpRunner.method;
-    console.log(chalk.green(`  ✓ mcp-atlassian disponível via ${via} (${mcpRunner.command}${mcpRunner.prefix.length > 0 ? ' ' + mcpRunner.prefix.join(' ') : ''})`));
+    console.log(chalk.green(`  ✓ mcp-atlassian disponível via ${via}`));
     pass++;
   } else {
-    console.log(chalk.yellow('  ⚠ mcp-atlassian não encontrado (nem direto, nem via uvx/pipx)'));
+    console.log(chalk.yellow('  ⚠ mcp-atlassian não encontrado'));
     for (const line of getInstallInstructions()) {
       console.log(chalk.dim(`    ${line}`));
     }
     fail++;
   }
 
-  // Check 7b: Python version >= 3.10 (required by mcp-atlassian)
-  // Try python3 first (Linux/macOS default), fall back to python (Windows default)
+  // Check 9: Python version >= 3.10
   try {
     let pyVersion;
     try {
@@ -200,21 +180,19 @@ export async function doctorCommand() {
       const major = Number(match[1]);
       const minor = Number(match[2]);
       if (major > 3 || (major === 3 && minor >= 10)) {
-        console.log(chalk.green(`  ✓ Python ${major}.${minor} (>= 3.10 exigido pelo mcp-atlassian)`));
+        console.log(chalk.green(`  ✓ Python ${major}.${minor}`));
         pass++;
       } else {
-        console.log(chalk.yellow(`  ⚠ Python ${major}.${minor} detectado — mcp-atlassian requer >= 3.10`));
-        console.log(chalk.dim('  Instale Python 3.10+: https://python.org/downloads'));
+        console.log(chalk.yellow(`  ⚠ Python ${major}.${minor} — mcp-atlassian requer >= 3.10`));
         fail++;
       }
     }
   } catch {
     console.log(chalk.yellow('  ⚠ Python não encontrado no PATH'));
-    console.log(chalk.dim('  Instale Python 3.10+: https://python.org/downloads'));
     fail++;
   }
 
-  // Check 8: Git repo
+  // Check 10: Git repo
   try {
     execSync('git rev-parse --is-inside-work-tree', { cwd, stdio: 'pipe', timeout: 10000 });
     console.log(chalk.green('  ✓ Repositório Git inicializado'));
@@ -224,127 +202,58 @@ export async function doctorCommand() {
     fail++;
   }
 
-  // Check 9: Dual-platform sync
-  if (agents.includes('claude') && agents.includes('copilot')) {
-    try {
-      const claudeAgent = await readFile(join(cwd, '.agents/agents/spec-hub.agent.md'), 'utf-8');
-      const copilotAgent = await readFile(join(cwd, '.github/agents/spec-hub.agent.md'), 'utf-8');
-
-      // Simple check: both should reference spec-agent
-      if (claudeAgent.includes('spec-agent') && copilotAgent.includes('spec-agent')) {
-        console.log(chalk.green('  ✓ Agents sincronizados entre Claude e Copilot'));
-        pass++;
-      } else {
-        console.log(chalk.yellow('  ⚠ Agents podem estar dessincronizados'));
-        fail++;
-      }
-    } catch {
-      console.log(chalk.yellow('  ⚠ Nao foi possivel verificar sincronizacao'));
-      fail++;
-    }
-  }
-
-  // Check 10: Figma MCP (optional — only if projects.yml declares figma)
-  const hasFigma = /figma:\s*\n\s+file_url:\s*\S+/.test(projectsContent);
-  if (hasFigma) {
-    if (claudeMcpContent) {
-      if (claudeMcpContent.includes('"figma"')) {
-        console.log(chalk.green('  ✓ .mcp.json (Claude) tem servidor Figma configurado'));
-        pass++;
-      } else {
-        console.log(chalk.yellow('  ⚠ projects.yml tem figma: mas .mcp.json não tem servidor figma'));
-        fail++;
-      }
-    }
-    if (copilotMcpContent) {
-      if (copilotMcpContent.includes('"figma"')) {
-        console.log(chalk.green('  ✓ .vscode/mcp.json (Copilot) tem servidor Figma configurado'));
-        pass++;
-      } else {
-        console.log(chalk.yellow('  ⚠ projects.yml tem figma: mas .vscode/mcp.json não tem servidor figma'));
-        fail++;
-      }
-    }
-  }
-
-  // Parse .env once for credential checks (11 + 12)
+  // Check 11: Confluence credentials (from global .env)
   let envVars = {};
   try {
-    const envContent = await readFile(join(cwd, '.env'), 'utf-8');
-    envVars = Object.fromEntries(
-      envContent.split('\n')
-        .filter(l => l.includes('=') && !l.startsWith('#'))
-        .map(l => { const idx = l.indexOf('='); return [l.slice(0, idx).trim(), l.slice(idx + 1).trim()]; }),
-    );
-  } catch {
-    // .env not found — already warned by MCP config check
-  }
+    const envContent = await readFile(getGlobalEnvPath(), 'utf-8');
+    envVars = parseEnvContent(envContent);
+  } catch { /* global .env not found */ }
 
-  const isPlaceholder = (v) => !v || v.includes('seu-') || v.includes('SEU-') || v === 'seu-api-token-aqui' || v === 'seu-figma-api-key';
+  const isPlaceholder = (v) => !v || v.includes('seu-') || v.includes('SEU-');
 
-  // Check 11: Confluence credentials — make real HTTP call to validate token
   {
     const confUrl = envVars.CONFLUENCE_URL;
     const confUser = envVars.CONFLUENCE_USERNAME;
     const confToken = envVars.CONFLUENCE_API_TOKEN;
 
     if (isPlaceholder(confUrl) || isPlaceholder(confUser) || isPlaceholder(confToken)) {
-      console.log(chalk.yellow('  ⚠ .env não configurado — pular validação de credenciais Confluence'));
-      console.log(chalk.dim('  Configure CONFLUENCE_URL, CONFLUENCE_USERNAME e CONFLUENCE_API_TOKEN no .env'));
+      console.log(chalk.yellow('  ⚠ Credenciais Confluence não configuradas no .env global'));
+      console.log(chalk.dim(`  Configure em: ${getGlobalEnvPath()}`));
       fail++;
     } else {
       try {
         await confluenceRequest(confUrl, '/rest/api/space?limit=1', confUser, confToken, 10000);
-        console.log(chalk.green('  ✓ Credenciais Confluence válidas (token ativo)'));
+        console.log(chalk.green('  ✓ Credenciais Confluence válidas'));
         pass++;
       } catch (err) {
         if (err.status === 401 || err.status === 403) {
-          console.log(chalk.red(`  ✗ Token Confluence inválido ou expirado (HTTP ${err.status})`));
-          console.log(chalk.dim('  Renove em: https://id.atlassian.com/manage-profile/security/api-tokens'));
-          console.log(chalk.dim('  Atualize CONFLUENCE_API_TOKEN no .env'));
+          console.log(chalk.red(`  ✗ Token Confluence inválido (HTTP ${err.status})`));
+          console.log(chalk.dim(`  Atualize em: ${getGlobalEnvPath()}`));
           fail++;
         } else {
-          console.log(chalk.yellow(`  ⚠ Não foi possível verificar credenciais Confluence: ${err.message}`));
+          console.log(chalk.yellow(`  ⚠ Não foi possível verificar credenciais: ${err.message}`));
           fail++;
         }
       }
     }
   }
 
-  // Check 12: Figma credentials — make real HTTP call to validate token
+  // Check 12: Figma credentials (optional)
+  const hasFigma = /figma:\s*\n\s+file_url:\s*\S+/.test(projectsContent);
   if (hasFigma) {
     const figmaKey = envVars.FIGMA_API_KEY;
-
     if (isPlaceholder(figmaKey)) {
-      console.log(chalk.yellow('  ⚠ FIGMA_API_KEY não configurado no .env'));
-      console.log(chalk.dim('  Gere em: Figma > Account Settings > Personal Access Tokens'));
+      console.log(chalk.yellow('  ⚠ FIGMA_API_KEY não configurado no .env global'));
       fail++;
     } else {
       try {
         const result = await figmaRequest(figmaKey, 10000);
-        console.log(chalk.green(`  ✓ Token Figma válido (usuário: ${result.data.handle || result.data.email || 'OK'})`));
+        console.log(chalk.green(`  ✓ Token Figma válido (${result.data.handle || result.data.email || 'OK'})`));
         pass++;
       } catch (err) {
         if (err.status === 401 || err.status === 403) {
-          console.log(chalk.red(`  ✗ Token Figma inválido ou expirado (HTTP ${err.status})`));
-          console.log(chalk.dim('  Renove em: Figma > Account Settings > Personal Access Tokens'));
-          console.log(chalk.dim('  Atualize FIGMA_API_KEY no .env'));
+          console.log(chalk.red(`  ✗ Token Figma inválido (HTTP ${err.status})`));
           fail++;
-        } else if (isSslError(err)) {
-          try {
-            const result = await figmaRequest(figmaKey, 10000, true);
-            console.log(chalk.green(`  ✓ Token Figma válido — SSL corporativo ignorado (usuário: ${result.data.handle || result.data.email || 'OK'})`));
-            pass++;
-          } catch (retryErr) {
-            if (retryErr.status === 401 || retryErr.status === 403) {
-              console.log(chalk.red(`  ✗ Token Figma inválido ou expirado (HTTP ${retryErr.status})`));
-              console.log(chalk.dim('  Renove em: Figma > Account Settings > Personal Access Tokens'));
-              console.log(chalk.dim('  Atualize FIGMA_API_KEY no .env'));
-            } else {
-              console.log(chalk.yellow(`  ⚠ Não foi possível verificar token Figma: ${retryErr.message}`));
-            }
-            fail++;
-          }
         } else {
           console.log(chalk.yellow(`  ⚠ Não foi possível verificar token Figma: ${err.message}`));
           fail++;
@@ -360,8 +269,9 @@ export async function doctorCommand() {
   console.log('');
 
   if (fail > 0) {
-    console.log(chalk.dim('  Execute "open-spec-kit init" para corrigir a estrutura.\n'));
+    console.log(chalk.dim('  Execute "open-spec-kit install" para corrigir a instalação global.'));
+    console.log(chalk.dim('  Execute "open-spec-kit init" para corrigir o projeto.\n'));
   } else {
-    console.log(chalk.green('  Ambiente pronto! Execute /setup para comecar.\n'));
+    console.log(chalk.green('  Ambiente pronto! Execute /osk-init para começar.\n'));
   }
 }