@guilhermefsousa/open-spec-kit 0.0.1

package/src/commands/update.js

@@ -0,0 +1,210 @@
+import chalk from 'chalk';
+import ora from 'ora';
+import { readFile, writeFile, access, mkdir, readdir } from 'fs/promises';
+import { join } from 'path';
+import yaml from 'yaml';
+
+export async function updateCommand() {
+  console.log(chalk.bold('\n  open-spec-kit update\n'));
+
+  const cwd = process.cwd();
+  const spinner = ora('Lendo projects.yml...').start();
+
+  try {
+    const projectsRaw = await readFile(join(cwd, 'projects.yml'), 'utf-8');
+    const projects = parseProjectsYaml(projectsRaw);
+
+    if (projects.agents.length === 0) {
+      spinner.fail('projects.yml não contém campo "agents". Execute "open-spec-kit init" primeiro.');
+      return;
+    }
+
+    spinner.succeed(`Agents configurados: ${projects.agents.join(', ')}`);
+
+    // Check source of truth files exist
+    const sourceFiles = [
+      '.agents/agents/spec-hub.agent.md',
+      '.agents/rules/ownership.instructions.md',
+      '.agents/rules/hub_structure.instructions.md',
+    ];
+
+    const missingSource = [];
+    for (const f of sourceFiles) {
+      try {
+        await access(join(cwd, f));
+      } catch {
+        missingSource.push(f);
+      }
+    }
+
+    if (missingSource.length > 0) {
+      console.log(chalk.yellow('\n  Arquivos fonte ausentes (source of truth):'));
+      missingSource.forEach(f => console.log(chalk.dim(`    - ${f}`)));
+      console.log(chalk.dim('  Execute "open-spec-kit init" para gerar.'));
+      return;
+    }
+
+    // Sync Copilot files if configured
+    if (projects.agents.includes('copilot')) {
+      const syncSpinner = ora('Sincronizando arquivos Copilot...').start();
+
+      const syncPairs = [
+        {
+          source: '.agents/rules/ownership.instructions.md',
+          target: '.github/instructions/ownership.instructions.md',
+          label: 'ownership rules',
+          transform: (content) => addCopilotFrontmatter(content, 'specs/**,docs/**,projects.yml,.agents/**')
+        },
+        {
+          source: '.agents/rules/hub_structure.instructions.md',
+          target: '.github/instructions/hub_structure.instructions.md',
+          label: 'structure rules',
+          transform: (content) => addCopilotFrontmatter(content, 'specs/**,docs/**,projects.yml')
+        },
+      ];
+
+      let synced = 0;
+      for (const { source, target, label, transform } of syncPairs) {
+        try {
+          const sourceContent = await readFile(join(cwd, source), 'utf-8');
+          const targetContent = transform(sourceContent);
+
+          let existingTarget = '';
+          try {
+            existingTarget = await readFile(join(cwd, target), 'utf-8');
+          } catch { /* target doesn't exist yet */ }
+
+          if (existingTarget !== targetContent) {
+            syncSpinner.text = `Atualizando ${label}...`;
+            await mkdir(join(cwd, '.github/instructions'), { recursive: true });
+            await writeFile(join(cwd, target), targetContent);
+            synced++;
+            console.log(chalk.green(`    ✓ ${label} sincronizado`));
+          }
+        } catch (err) {
+          console.log(chalk.yellow(`    ⚠ Não foi possível sincronizar ${label}: ${err.message}`));
+        }
+      }
+
+      if (synced > 0) {
+        syncSpinner.succeed(`${synced} arquivo(s) Copilot atualizado(s)`);
+      } else {
+        syncSpinner.succeed('Arquivos Copilot já estão sincronizados');
+      }
+
+      // Sync skills: .agents/skills/*/SKILL.md → .github/skills/*/SKILL.md
+      const skillsSpinner = ora('Sincronizando skills...').start();
+      let skillsSynced = 0;
+      try {
+        const skillsDir = join(cwd, '.agents', 'skills');
+        const skillEntries = await readdir(skillsDir, { withFileTypes: true });
+        const skillDirs = skillEntries.filter(e => e.isDirectory()).map(e => e.name);
+
+        for (const skillName of skillDirs) {
+          const source = join(skillsDir, skillName, 'SKILL.md');
+          const target = join(cwd, '.github', 'skills', skillName, 'SKILL.md');
+
+          try {
+            const sourceContent = await readFile(source, 'utf-8');
+
+            let existingTarget = '';
+            try {
+              existingTarget = await readFile(target, 'utf-8');
+            } catch { /* target doesn't exist yet */ }
+
+            if (existingTarget !== sourceContent) {
+              await mkdir(join(cwd, '.github', 'skills', skillName), { recursive: true });
+              await writeFile(target, sourceContent);
+              skillsSynced++;
+              console.log(chalk.green(`    ✓ skill ${skillName} sincronizado`));
+            }
+          } catch (err) {
+            if (err.code !== 'ENOENT') {
+              console.log(chalk.yellow(`    ⚠ Não foi possível sincronizar skill ${skillName}: ${err.message}`));
+            }
+          }
+        }
+
+        if (skillsSynced > 0) {
+          skillsSpinner.succeed(`${skillsSynced} skill(s) Copilot atualizado(s)`);
+        } else {
+          skillsSpinner.succeed('Skills Copilot já estão sincronizados');
+        }
+      } catch {
+        skillsSpinner.warn('Diretório .agents/skills/ não encontrado — skills não sincronizados');
+      }
+    }
+
+    // Check MCP configs
+    if (projects.agents.includes('claude')) {
+      try {
+        await access(join(cwd, '.mcp.json'));
+        console.log(chalk.green('  ✓ .mcp.json (Claude Code) encontrado'));
+      } catch {
+        console.log(chalk.yellow('  ✗ .mcp.json (Claude Code) ausente — crie manualmente'));
+      }
+    }
+
+    if (projects.agents.includes('copilot')) {
+      try {
+        await access(join(cwd, '.vscode/mcp.json'));
+        console.log(chalk.green('  ✓ .vscode/mcp.json (Copilot) encontrado'));
+      } catch {
+        console.log(chalk.yellow('  ✗ .vscode/mcp.json (Copilot) ausente — execute init'));
+      }
+    }
+
+    // Check for spec-hub agent divergence between Claude and Copilot
+    if (projects.agents.includes('claude') && projects.agents.includes('copilot')) {
+      try {
+        const claudeAgentRaw = await readFile(join(cwd, '.agents/agents/spec-hub.agent.md'), 'utf-8');
+        const copilotAgentRaw = await readFile(join(cwd, '.github/agents/spec-hub.agent.md'), 'utf-8');
+
+        // Strip frontmatter (--- ... ---) from both to compare functional content
+        const stripFrontmatter = (content) => content.replace(/^---\n[\s\S]*?\n---\n+/, '').trim();
+        const claudeBody = stripFrontmatter(claudeAgentRaw);
+        const copilotBody = stripFrontmatter(copilotAgentRaw);
+
+        if (claudeBody === copilotBody) {
+          console.log(chalk.green('  ✓ spec-hub agent sincronizado entre Claude e Copilot'));
+        } else {
+          console.log(chalk.yellow('  ⚠ spec-hub agent diverge entre Claude (.agents/) e Copilot (.github/)'));
+          console.log(chalk.dim('  Atualize manualmente: o conteúdo funcional diferente entre plataformas.'));
+          console.log(chalk.dim('  Claude: .agents/agents/spec-hub.agent.md'));
+          console.log(chalk.dim('  Copilot: .github/agents/spec-hub.agent.md'));
+        }
+      } catch {
+        console.log(chalk.yellow('  ⚠ Não foi possível verificar divergência dos agent files'));
+      }
+    }
+
+    console.log('');
+
+  } catch (err) {
+    spinner.fail(`Erro: ${err.message}`);
+    process.exit(1);
+  }
+}
+
+function addCopilotFrontmatter(content, applyTo) {
+  // Remove existing frontmatter if present
+  const withoutFrontmatter = content.replace(/^---\n[\s\S]*?\n---\n/, '');
+  return `---\napplyTo: "${applyTo}"\n---\n\n${withoutFrontmatter.trim()}\n`;
+}
+
+/**
+ * Parse projects.yml using the yaml package (robust — handles all valid YAML).
+ */
+function parseProjectsYaml(content) {
+  try {
+    const data = yaml.parse(content);
+    const agents = data?.project?.agents;
+    return {
+      agents: Array.isArray(agents) ? agents : [],
+      preset: data?.project?.preset || 'standard',
+      name: data?.project?.name || '',
+    };
+  } catch {
+    return { agents: [], preset: 'standard', name: '' };
+  }
+}