@dynamicworks/br-openspec 2.0.0 → 2.1.0

package/dist/messages/index.js

@@ -3,6 +3,28 @@
  *
  * Este módulo reúne todas as mensagens exibidas ao usuário para facilitar
  * manutenção, revisão e consistência linguística.
+ *
+ * ─────────────────────────────────────────────────────────────────────────
+ * ⚠️ TERMOS RESERVADOS — NÃO TRADUZIR
+ * ─────────────────────────────────────────────────────────────────────────
+ * O BR-OpenSpec é PT-BR first, mas o FORMATO de spec é um protocolo lido pelo
+ * parser e pelo validador. Os marcadores estruturais e as palavras-chave
+ * normativas DEVEM permanecer em inglês e em CAIXA ALTA. Só o conteúdo
+ * descritivo (nomes, descrições, prosa) é escrito em português.
+ *
+ * - Palavras-chave normativas (RFC 2119): MUST, MUST NOT, REQUIRED, SHALL,
+ *   SHALL NOT, SHOULD, SHOULD NOT, RECOMMENDED, MAY, OPTIONAL.
+ * - Cabeçalhos de delta/spec: "## ADDED Requirements", "## MODIFIED Requirements",
+ *   "## REMOVED Requirements", "## RENAMED Requirements", "## Requirements",
+ *   "### Requirement:", "#### Scenario:".
+ * - Cláusulas de cenário (Gherkin): WHEN, THEN, AND, GIVEN, ELSE.
+ * - Auxiliares de RENAMED: FROM, TO.
+ *
+ * Regra geral: qualquer palavra em CAIXA ALTA que represente uma regra, uma
+ * operação de delta (ADD/REMOVE/RENAME) ou uma cláusula de cenário fica em
+ * inglês. Traduzir esses termos quebra o parsing/validação dos specs.
+ * Ver também AGENTS.md ("Termos reservados em inglês").
+ * ─────────────────────────────────────────────────────────────────────────
  */
 // ═══════════════════════════════════════════════════════════
 // CLI — Descrições de comandos (src/cli/index.ts)
@@ -514,6 +536,8 @@ export const CONFIG_MESSAGES = {
     workflowBulkArchiveDesc: 'Arquiva múltiplas alterações concluídas juntas',
     workflowVerifyName: 'Verificar alteração',
     workflowVerifyDesc: 'Executa verificações contra uma alteração',
+    workflowCodeReviewName: 'Code review',
+    workflowCodeReviewDesc: 'Revisa diffs, branches ou arquivos com contexto do projeto',
     workflowOnboardName: 'Onboarding',
     workflowOnboardDesc: 'Fluxo de onboarding guiado para o BR-OpenSpec',
 };
@@ -669,6 +693,38 @@ export const COMPLETION_MESSAGES = {
     warningCouldNotRemoveLegacy: (path, err) => `Aviso: Não foi possível remover arquivo legado ${path}: ${err}`,
     powershellCompletionHeader: '# Script de autocompletar PowerShell para a CLI do BR-OpenSpec',
     powershellCompletionNote: '# Gerado automaticamente - não edite manualmente',
+    // Fish installer messages
+    fishAlreadyInstalled: 'Script de autocomplete já está instalado (atualizado)',
+    fishAlreadyInstalledDetail: 'O script de autocomplete já está instalado e atualizado.',
+    fishAutoLoadsHint: 'O Fish carrega automaticamente os scripts de autocomplete - devem estar disponíveis imediatamente.',
+    fishUpdatedWithBackup: 'Script de autocomplete atualizado com sucesso (versão anterior salva em backup)',
+    fishUpdated: 'Script de autocomplete atualizado com sucesso',
+    fishInstalled: 'Script de autocomplete instalado com sucesso para Fish',
+    fishAutoLoadsDir: 'O Fish carrega automaticamente os scripts de autocomplete de ~/.config/fish/completions/',
+    fishAvailableImmediately: 'Os autocompletes estão disponíveis imediatamente - sem necessidade de reiniciar o shell.',
+    fishFailedToInstall: (error) => `Falha ao instalar script de autocomplete: ${error}`,
+    fishNotInstalled: 'Script de autocomplete não está instalado',
+    fishUninstalled: 'Script de autocomplete desinstalado com sucesso',
+    fishFailedToUninstall: (error) => `Falha ao desinstalar script de autocomplete: ${error}`,
+    // PowerShell installer messages
+    powershellUtf16BEUnsupported: 'Arquivo codificado em UTF-16 BE não é suportado. Salve novamente como UTF-8 ou UTF-16 LE e tente novamente.',
+    powershellAlreadyInstalled: 'Script de autocomplete já está instalado (atualizado)',
+    powershellAlreadyInstalledDetail: 'O script de autocomplete já está instalado e atualizado.',
+    powershellAlreadyInstalledHint: 'Se o autocomplete não estiver funcionando, tente reiniciar o PowerShell ou execute: . $PROFILE',
+    powershellUpdatedWithBackup: 'Script de autocomplete atualizado com sucesso (versão anterior salva em backup)',
+    powershellUpdated: 'Script de autocomplete atualizado com sucesso',
+    powershellInstalledWithProfile: 'Script de autocomplete instalado e perfil do PowerShell configurado com sucesso',
+    powershellInstalled: 'Script de autocomplete instalado com sucesso para PowerShell',
+    powershellFailedToInstall: (error) => `Falha ao instalar script de autocomplete: ${error}`,
+    powershellScriptInstalled: 'Script de autocomplete instalado com sucesso.',
+    powershellEnableCompletions: (profilePath) => `Para ativar o autocomplete, adicione o seguinte ao seu perfil PowerShell (${profilePath}):`,
+    powershellSourceComment: '# Carrega os autocompletes do BR-OpenSpec',
+    powershellThenRestart: 'Depois reinicie o PowerShell ou execute: . $PROFILE',
+    powershellNotInstalled: 'Script de autocomplete não está instalado',
+    powershellUninstalled: 'Script de autocomplete desinstalado com sucesso',
+    powershellFailedToUninstall: (error) => `Falha ao desinstalar script de autocomplete: ${error}`,
+    // Zsh installer (missing)
+    zshNotInstalled: 'Script de autocomplete não está instalado',
 };
 // ═══════════════════════════════════════════════════════════
 // Comandos — Feedback (src/commands/feedback.ts)
@@ -767,6 +823,8 @@ export const UPDATE_MESSAGES = {
     it: 'ela',
     them: 'elas',
     extraWorkflowsNote: (count) => `Nota: ${count} fluxos de trabalho extras não estão no perfil (use \`openspec config profile\` para gerenciar)`,
+    oldCoreProfileSyncNote: 'Nota: o perfil core agora inclui o fluxo de trabalho sync. Seu perfil personalizado está mantendo o conjunto antigo de fluxos de trabalho do core.',
+    oldCoreProfileSyncHint: 'Execute `openspec config profile core` e depois `openspec update` para adicionar o sync.',
     cleaningLegacy: 'Limpando arquivos legados...',
     legacyCleaned: 'Arquivos legados limpos',
     forceLegacyHint: '⚠ Execute com --force para limpar automaticamente arquivos legados, ou execute de forma interativa.',
@@ -809,11 +867,21 @@ export const VALIDATOR_MESSAGES = {
     unknownError: 'Erro desconhecido',
     duplicateRequirementAdded: (name) => `Requisito duplicado em ADDED: "${name}"`,
     missingRequirementTextAdded: (name) => `ADDED "${name}" está sem texto de requisito`,
-    missingShallOrMustAdded: (name) => `ADDED "${name}" deve conter SHALL ou MUST`,
+    missingShallOrMustAdded: (name, keywordInHeader = false) => {
+        const base = `ADDED "${name}" deve conter SHALL ou MUST`;
+        return keywordInHeader
+            ? `${base} no corpo do requisito, não apenas no cabeçalho. Mova a declaração SHALL/MUST para a linha imediatamente após o cabeçalho "### Requirement: ...".`
+            : base;
+    },
     missingScenarioAdded: (name) => `ADDED "${name}" deve incluir pelo menos um cenário`,
     duplicateRequirementModified: (name) => `Requisito duplicado em MODIFIED: "${name}"`,
     missingRequirementTextModified: (name) => `MODIFIED "${name}" está sem texto de requisito`,
-    missingShallOrMustModified: (name) => `MODIFIED "${name}" deve conter SHALL ou MUST`,
+    missingShallOrMustModified: (name, keywordInHeader = false) => {
+        const base = `MODIFIED "${name}" deve conter SHALL ou MUST`;
+        return keywordInHeader
+            ? `${base} no corpo do requisito, não apenas no cabeçalho. Mova a declaração SHALL/MUST para a linha imediatamente após o cabeçalho "### Requirement: ...".`
+            : base;
+    },
     missingScenarioModified: (name) => `MODIFIED "${name}" deve incluir pelo menos um cenário`,
     duplicateRequirementRemoved: (name) => `Requisito duplicado em REMOVED: "${name}"`,
     duplicateFromRenamed: (name) => `FROM duplicado em RENAMED: "${name}"`,
@@ -1289,11 +1357,11 @@ Aqui está um rascunho de proposal:
 
 ---
 
-## Por Que
+## Why
 
 [1-2 frases explicando o problema/oportunidade]
 
-## O Que Muda
+## What Changes
 
 [Bullet points do que será diferente]
 
@@ -1357,21 +1425,21 @@ Aqui está o spec:
 
 ---
 
-## Requisitos ADICIONADOS
+## ADDED Requirements
 
-### Requisito: <Nome>
+### Requirement: <Nome>
 
-<Descrição do que o sistema deve fazer>
+O sistema SHALL <descrição do que o sistema deve fazer>
 
-#### Cenário: <Nome do cenário>
+#### Scenario: <Nome do cenário>
 
-- **QUANDO** <condição de gatilho>
-- **ENTÃO** <resultado esperado>
-- **E** <resultado adicional se necessário>
+- **WHEN** <condição de gatilho>
+- **THEN** <resultado esperado>
+- **AND** <resultado adicional se necessário>
 
 ---
 
-Este formato - QUANDO/ENTÃO/E - torna os requisitos testáveis. Você pode literalmente lê-los como casos de teste.
+Este formato - WHEN/THEN/AND - torna os requisitos testáveis. Você pode literalmente lê-los como casos de teste. Os marcadores estruturais (ADDED Requirements, Requirement, Scenario) e as palavras-chave (WHEN/THEN/AND, SHALL/MUST) ficam SEMPRE em inglês — é o protocolo que o parser e o validador reconhecem. Apenas o conteúdo descritivo é escrito em português.
 \`\`\`
 
 Salve em \`openspec/changes/<nome>/specs/<capability>/spec.md\`.
@@ -1952,9 +2020,249 @@ Use markdown claro com:
 - Sem sugestões vagas como "consider reviewing"`,
 };
 // ═══════════════════════════════════════════════════════════
+// Templates de Workflow — Code Review (src/core/templates/workflows/code-review.ts)
+// ═══════════════════════════════════════════════════════════
+export const CODE_REVIEW_TEMPLATE_MESSAGES = {
+    skillDescription: 'Realiza code review genérico e consciente do projeto. Use quando o usuário quiser revisar um diff, branch, PR, working tree ou conjunto de arquivos antes de mesclar ou continuar.',
+    skillCompatibility: 'Requer acesso aos arquivos do projeto. Git é recomendado para revisar diffs e branches.',
+    opsxDescription: 'Revisa diffs, branches, PRs ou arquivos usando contexto do projeto',
+    instructions: `Realize um code review rigoroso, genérico e consciente do projeto. Seu objetivo é encontrar problemas reais antes do merge — não validar superficialmente, não comentar estilo, não elogiar.
+
+**Entrada**: Opcionalmente especifique o alvo após \`/opsx:code-review\`: branch, PR, diff, working tree, staged changes, caminho de arquivo ou descrição de escopo. Se omitido, descubra o alvo com segurança.
+
+**Postura**
+
+- Você está revisando, não implementando. Não edite arquivos a menos que o usuário peça explicitamente para corrigir.
+- Aja como um revisor sênior cético: assuma que existe um bug até o código provar o contrário, e fundamente cada finding com evidência concreta no código.
+- Priorize nesta ordem: correção/regressões → segurança/privacidade → perda ou corrupção de dados → quebra de contrato/compatibilidade → concorrência → comportamento cross-platform → testes ausentes → performance → manutenibilidade.
+- Estilo e preferência pessoal só viram finding se tiverem impacto concreto (ex.: legibilidade que esconde um bug, violação de um padrão real do projeto).
+- Findings primeiro, com evidência. Resumo depois.
+- Calibre a profundidade ao tamanho do diff; em diffs grandes, revise por blocos e priorize as áreas de maior risco.
+- Sinalize incerteza explicitamente. Nunca invente número de linha, nome de símbolo ou comportamento que você não verificou.
+
+**Passos**
+
+1. **Determine o alvo da review**
+
+   Use o argumento do usuário quando existir. Caso contrário, descubra com segurança:
+   - Confirme se há Git: \`git rev-parse --is-inside-work-tree\`.
+   - Inspecione o estado local: \`git status --short\`, \`git diff\` (unstaged) e \`git diff --staged\`.
+   - Para revisar um branch contra a base: identifique a base provável (ex.: \`git merge-base HEAD origin/main\`) e use \`git diff <base>...HEAD\`.
+   - Para um PR, prefira \`gh pr diff <numero>\` quando o \`gh\` estiver disponível.
+   - Se não houver Git, peça arquivos ou escopo explícitos ao usuário.
+   - Se o alvo continuar ambíguo, pergunte ao usuário o que revisar.
+
+   Não assuma review do repositório inteiro sem confirmação. Leia o diff completo (com contexto de linha) antes de julgar.
+
+2. **Entenda a intenção antes de criticar**
+
+   Antes de procurar defeitos, articule o que a mudança tenta fazer e por quê (a partir do título do PR/branch, mensagens de commit, artifacts OpenSpec ou do próprio diff). Um bom review compara o que o código faz com o que deveria fazer; sem a intenção, você só consegue revisar sintaxe.
+
+3. **Colete contexto do projeto**
+
+   Leia apenas os arquivos relevantes, priorizando:
+   - \`README.md\`, \`README_*.md\` e docs de contribuição
+   - \`AGENTS.md\`, instruções de agentes e skills existentes do projeto
+   - \`openspec/config.yaml\` e docs de arquitetura/ADRs quando existirem
+   - specs vivas em \`openspec/specs/\` quando relacionadas ao alvo
+   - testes vizinhos ao código alterado (para entender o contrato esperado)
+   - manifests e configs de stack (\`package.json\`, lockfiles, \`tsconfig.json\`, configs de lint/test/build, CI etc.)
+
+   Aplique as instruções encontradas. Em caso de conflito, prefira a orientação mais específica do repositório.
+
+4. **Entenda a stack e os comandos de verificação**
+
+   Infira linguagem, framework, package manager e comandos úteis a partir dos arquivos locais.
+
+   Exemplos:
+   - Node/TypeScript: scripts de \`package.json\`, lockfile e \`tsconfig.json\`
+   - Python: \`pyproject.toml\`, \`requirements*.txt\`, configs de pytest/ruff/mypy
+   - Go/Rust: \`go.mod\`, \`Cargo.toml\` e scripts de CI
+
+5. **Inclua contexto OpenSpec quando existir**
+
+   Se houver uma change relacionada:
+   - Leia \`proposal.md\`, \`design.md\`, \`tasks.md\` e delta specs disponíveis.
+   - Verifique se o diff preserva a intenção dos artifacts.
+   - Não transforme esta review em \`/opsx:verify\`; use os artifacts apenas como contexto adicional para revisar o código.
+
+6. **Revise o código em profundidade**
+
+   Método para cada mudança: leia além do diff (o código ao redor, chamadores e implementações chamadas), rastreie de onde vêm os dados e para onde vão, e teste mentalmente entradas adversárias (vazio, nulo, zero, negativo, muito grande, unicode, concorrente). Não confie no nome de uma função — confirme o que ela faz.
+
+   Procure, por categoria:
+   - **Correção e lógica**: regressões, edge cases e limites (off-by-one), condições invertidas ou incompletas, \`switch\` sem \`break\`/default, retorno/await faltando, suposições falsas sobre a entrada.
+   - **Dados e estado**: mutação de estado compartilhado, ordem de operações, idempotência, transações e atomicidade, invalidação de cache, lifecycle e limpeza de recursos.
+   - **Concorrência**: race conditions, \`await\`/lock faltando, reentrância, deadlock, escrita concorrente.
+   - **Segurança e privacidade**: injeção (SQL/command/path/template), validação e sanitização de entrada não confiável, authn/authz, segredos hardcoded, dados sensíveis vazando em logs/erros, deserialização insegura, SSRF/path traversal.
+   - **Erros e resiliência**: erros engolidos, mensagens que vazam dados, ausência de rollback, retries/timeouts, recursos não liberados em caminho de erro.
+   - **Contratos e compatibilidade**: mudança em API pública, assinatura, schema ou formato persistido; migrações reversíveis; compatibilidade retroativa e versionamento.
+   - **Cross-platform**: separador de caminho, case sensitivity, line endings, shell e encoding quando filesystem/processo estiverem envolvidos.
+   - **Performance**: N+1, complexidade quadrática, I/O ou alocação dentro de loop — reporte apenas quando o impacto for plausível.
+   - **Testes**: cenários novos/quebráveis cobertos, testes negativos e de borda, testes frágeis ou que não exercitam de fato o código.
+   - **Dependências**: nova dependência justificada, versão e licença sãs, risco de supply chain.
+   - **Consistência com o projeto**: aderência a padrões, convenções e decisões reais do repositório (incluindo, quando aplicável, mensagens centralizadas/i18n em vez de texto hardcoded).
+
+7. **Valide quando for seguro**
+
+   Rode verificações focadas e proporcionais (typecheck, lint, testes do escopo afetado) quando forem seguras. Não rode comandos destrutivos, dependentes de serviços externos ou desproporcionalmente caros sem explicar/confirmar. Reporte o que rodou e o que pulou (e por quê).
+
+8. **Sugira contexto durável do projeto**
+
+   Se o projeto não tiver orientação durável suficiente para reviews (nenhum \`AGENTS.md\`, skill do projeto, docs de contribuição ou contexto em \`openspec/config.yaml\`):
+   - Sugira criar ou enriquecer uma skill/contexto do projeto para futuras reviews, indicando um local concreto (ex.: \`AGENTS.md\` ou uma skill do projeto) e os pontos que ela deveria registrar (padrões, comandos de validação, armadilhas).
+   - Explique brevemente o benefício.
+   - Peça confirmação antes de escrever qualquer arquivo.
+
+**Formato de Saída**
+
+Se houver findings, comece por eles, ordenados por severidade. Para cada finding:
+
+\`\`\`text
+Findings
+- [CRITICAL] caminho/arquivo.ext:123 — Título curto e específico
+  Evidência: o que no código causa o problema (cite o trecho/símbolo)
+  Impacto: o que quebra na prática e sob qual condição
+  Correção: ação concreta e mínima
+  Confiança: alta | média | baixa (se < alta, diga a suposição)
+\`\`\`
+
+Depois inclua, de forma breve:
+- alvo revisado
+- contexto/instruções considerados
+- validações executadas
+- validações não executadas e por quê
+- risco residual ou perguntas abertas
+
+Se não houver findings, diga claramente que nenhum problema foi encontrado e ainda informe as validações não executadas.
+
+**Regras de Severidade**
+
+- **CRITICAL**: bug provável, perda/corrupção de dados, falha de segurança, quebra de contrato, build/test claramente quebrado.
+- **WARNING**: risco real mas dependente de condição, cobertura ausente para comportamento importante, inconsistência que pode virar regressão.
+- **SUGGESTION**: melhoria útil, baixa urgência, refino de manutenção.
+
+**Guardrails**
+
+- Não altere arquivos durante uma review pura.
+- Todo finding precisa de evidência concreta; sem evidência, não reporte.
+- Não reporte o que linter/typecheck/formatter já pegam automaticamente — foque no que essas ferramentas não veem.
+- Não duplique o mesmo finding; agrupe ocorrências do mesmo problema.
+- Prefira poucos findings fortes a muitos comentários especulativos.
+- Não encha a saída com elogios genéricos.
+- Use referências no formato \`arquivo:linha\`; quando não houver linha exata, cite o menor escopo verificável.
+- Se a informação for incerta, diga o que verificou e qual suposição está fazendo — e marque a confiança.`,
+};
+// ═══════════════════════════════════════════════════════════
 // Telemetry (src/telemetry/index.ts)
 // ═══════════════════════════════════════════════════════════
 export const TELEMETRY_MESSAGES = {
     firstRunNotice: 'Aviso: o BR-OpenSpec coleta estatísticas de uso anônimas. Para optar por não participar, defina OPENSPEC_TELEMETRY=0',
 };
+// ═══════════════════════════════════════════════════════════
+// Parser — Change Parser (src/core/parsers/change-parser.ts)
+// ═══════════════════════════════════════════════════════════
+export const CHANGE_PARSER_MESSAGES = {
+    mustHaveWhySection: 'A alteração deve ter uma seção Why',
+    mustHaveWhatChangesSection: 'A alteração deve ter uma seção What Changes',
+    addRequirement: (text) => `Adicionar requisito: ${text}`,
+    modifyRequirement: (text) => `Modificar requisito: ${text}`,
+    removeRequirement: (text) => `Remover requisito: ${text}`,
+    renameRequirement: (from, to) => `Renomear requisito de "${from}" para "${to}"`,
+};
+// ═══════════════════════════════════════════════════════════
+// Core — Specs Apply (src/core/specs-apply.ts)
+// ═══════════════════════════════════════════════════════════
+export const SPECS_APPLY_MESSAGES = {
+    duplicateInSection: (specName, section, reqName) => `${specName} validação falhou - requisito duplicado em ${section} para cabeçalho "### Requirement: ${reqName}"`,
+    duplicateFromInRenamed: (specName, reqName) => `${specName} validação falhou - FROM duplicado em RENAMED para cabeçalho "### Requirement: ${reqName}"`,
+    duplicateToInRenamed: (specName, reqName) => `${specName} validação falhou - TO duplicado em RENAMED para cabeçalho "### Requirement: ${reqName}"`,
+    renamedModifiedMustReferenceNew: (specName, toName) => `${specName} validação falhou - quando existe um rename, MODIFIED deve referenciar o NOVO cabeçalho "### Requirement: ${toName}"`,
+    renamedToCollidesWithAdded: (specName, toName) => `${specName} validação falhou - cabeçalho RENAMED TO colide com ADDED para "### Requirement: ${toName}"`,
+    requirementInMultipleSections: (specName, sectionA, sectionB, reqName) => `${specName} validação falhou - requisito presente em múltiplas seções (${sectionA} e ${sectionB}) para cabeçalho "### Requirement: ${reqName}"`,
+    noDeltaOperations: (capability) => `Análise de delta não encontrou operações para ${capability}. Forneça seções ADDED/MODIFIED/REMOVED/RENAMED no spec da change.`,
+    targetSpecNotExists: (specName) => `${specName}: spec alvo não existe; somente requisitos ADDED são permitidos para specs novos. Operações MODIFIED e RENAMED requerem um spec existente.`,
+    targetSpecStructurallyInvalid: (specName, details) => `${specName}: spec alvo é estruturalmente inválido e não pode ser atualizado até ser corrigido:\n${details}`,
+    renamedFailedSourceNotFound: (specName, reqName) => `${specName} RENAMED falhou para cabeçalho "### Requirement: ${reqName}" - origem não encontrada`,
+    renamedFailedTargetExists: (specName, reqName) => `${specName} RENAMED falhou para cabeçalho "### Requirement: ${reqName}" - destino já existe`,
+    removedFailedNotFound: (specName, reqName) => `${specName} REMOVED falhou para cabeçalho "### Requirement: ${reqName}" - não encontrado`,
+    modifiedFailedNotFound: (specName, reqName) => `${specName} MODIFIED falhou para cabeçalho "### Requirement: ${reqName}" - não encontrado`,
+    modifiedFailedHeaderMismatch: (specName, reqName) => `${specName} MODIFIED falhou para cabeçalho "### Requirement: ${reqName}" - incompatibilidade de cabeçalho no conteúdo`,
+    addedFailedAlreadyExists: (specName, reqName) => `${specName} ADDED falhou para cabeçalho "### Requirement: ${reqName}" - já existe`,
+    applyingChangesTo: (specPath) => `Aplicando alterações em openspec/specs/${specPath}/spec.md:`,
+    wouldApplyChangesTo: (specPath) => `Aplicaria alterações em openspec/specs/${specPath}/spec.md:`,
+    countAdded: (n) => `  + ${n} adicionado(s)`,
+    countModified: (n) => `  ~ ${n} modificado(s)`,
+    countRemoved: (n) => `  - ${n} removido(s)`,
+    countRenamed: (n) => `  → ${n} renomeado(s)`,
+    skeletonPurpose: (changeName) => `A definir - criado ao arquivar alteração ${changeName}. Atualize o Purpose após o arquivamento.`,
+    changeNotFound: (changeName) => `Alteração '${changeName}' não encontrada.`,
+    validationErrorsInRebuiltSpec: (specName, errors) => `Erros de validação na especificação reconstruída para ${specName}:\n${errors}`,
+};
+// ═══════════════════════════════════════════════════════════
+// Core — Project Config (src/core/project-config.ts)
+// ═══════════════════════════════════════════════════════════
+export const PROJECT_CONFIG_SUGGEST_MESSAGES = {
+    configNotValidYaml: 'openspec/config.yaml não é um objeto YAML válido',
+    configFailedToParse: 'Falha ao analisar openspec/config.yaml:',
+    unknownArtifactId: (artifactId, schemaName, validIds) => `ID de artefato desconhecido nas regras: "${artifactId}". IDs válidos para o schema "${schemaName}": ${validIds}`,
+    schemaNotFound: (schemaName) => `Schema '${schemaName}' não encontrado em openspec/config.yaml\n\n`,
+    didYouMean: 'Você quis dizer algum destes?\n',
+    schemaType: (isBuiltIn) => isBuiltIn ? 'nativo' : 'local do projeto',
+    availableSchemas: 'Schemas disponíveis:\n',
+    builtInSchemas: (schemas) => `  Nativos: ${schemas}\n`,
+    projectLocalSchemas: (schemas) => `  Locais do projeto: ${schemas}\n`,
+    noProjectLocalSchemas: '  Locais do projeto: (nenhum encontrado)\n',
+    fixSuggestion: (invalidName) => `\nCorreção: Edite openspec/config.yaml e altere 'schema: ${invalidName}' para um nome de schema válido`,
+};
+// ═══════════════════════════════════════════════════════════
+// Core — Tools Manager (src/core/tools-manager.ts)
+// ═══════════════════════════════════════════════════════════
+export const TOOLS_MANAGER_MESSAGES = {
+    toolDoesNotSupportSkills: (toolValue) => `A ferramenta '${toolValue}' não suporta geração de skills.`,
+};
+// ═══════════════════════════════════════════════════════════
+// Core — Artifact Graph (src/core/artifact-graph/)
+// ═══════════════════════════════════════════════════════════
+export const ARTIFACT_GRAPH_MESSAGES = {
+    invalidSchema: (errors) => `Schema inválido: ${errors}`,
+    duplicateArtifactId: (id) => `ID de artefato duplicado: ${id}`,
+    invalidDependencyReference: (artifactId, ref) => `Referência de dependência inválida no artefato '${artifactId}': '${ref}' não existe`,
+    cyclicDependency: (cycle) => `Dependência cíclica detectada: ${cycle}`,
+    templateNotFound: (path) => `Template não encontrado: ${path}`,
+    failedToReadTemplate: (error) => `Falha ao ler template: ${error}`,
+    artifactNotFound: (artifactId, schemaName) => `Artefato '${artifactId}' não encontrado no schema '${schemaName}'`,
+};
+// ═══════════════════════════════════════════════════════════
+// Utils — Change Metadata (src/utils/change-metadata.ts)
+// ═══════════════════════════════════════════════════════════
+export const CHANGE_METADATA_MESSAGES = {
+    failedToWriteMetadata: (error) => `Falha ao escrever metadados: ${error}`,
+    failedToReadMetadata: (error) => `Falha ao ler metadados: ${error}`,
+    invalidMetadata: (error) => `Metadados inválidos: ${error}`,
+    invalidYaml: (error) => `YAML inválido no arquivo de metadados: ${error}`,
+    unknownSchema: (schema, available) => `Schema desconhecido '${schema}'. Disponíveis: ${available}`,
+};
+// ═══════════════════════════════════════════════════════════
+// Utils — Change Utils (src/utils/change-utils.ts)
+// ═══════════════════════════════════════════════════════════
+export const CHANGE_UTILS_MESSAGES = {
+    changeAlreadyExists: (name, dir) => `A alteração '${name}' já existe em ${dir}`,
+    nameEmpty: 'O nome da alteração não pode estar vazio',
+    nameMustBeLowercase: 'O nome da alteração deve ser minúsculo (use kebab-case)',
+    nameNoSpaces: 'O nome da alteração não pode conter espaços (use hífens)',
+    nameNoUnderscores: 'O nome da alteração não pode conter underscores (use hífens)',
+    nameNoStartHyphen: 'O nome da alteração não pode começar com hífen',
+    nameNoEndHyphen: 'O nome da alteração não pode terminar com hífen',
+    nameNoConsecutiveHyphens: 'O nome da alteração não pode conter hífens consecutivos',
+    nameOnlyAllowedChars: 'O nome da alteração pode conter apenas letras minúsculas, números e hífens',
+    nameMustStartWithLetter: 'O nome da alteração deve começar com uma letra',
+    nameKebabCase: 'O nome da alteração deve seguir a convenção kebab-case (ex: add-auth, refactor-db)',
+};
+// ═══════════════════════════════════════════════════════════
+// Core — Completions Factory (src/core/completions/factory.ts)
+// ═══════════════════════════════════════════════════════════
+export const COMPLETIONS_FACTORY_MESSAGES = {
+    unsupportedShell: (shell) => `Shell não suportado: ${shell}`,
+};
 //# sourceMappingURL=index.js.map

package/dist/utils/change-metadata.js

@@ -4,6 +4,7 @@ import * as yaml from 'yaml';
 import { ChangeMetadataSchema } from '../core/artifact-graph/types.js';
 import { listSchemas } from '../core/artifact-graph/resolver.js';
 import { readProjectConfig } from '../core/project-config.js';
+import { CHANGE_METADATA_MESSAGES } from '../messages/index.js';
 const METADATA_FILENAME = '.openspec.yaml';
 /**
  * Error thrown when change metadata validation fails.
@@ -29,7 +30,7 @@ export class ChangeMetadataError extends Error {
 export function validateSchemaName(schemaName, projectRoot) {
     const availableSchemas = listSchemas(projectRoot);
     if (!availableSchemas.includes(schemaName)) {
-        throw new Error(`Unknown schema '${schemaName}'. Available: ${availableSchemas.join(', ')}`);
+        throw new Error(CHANGE_METADATA_MESSAGES.unknownSchema(schemaName, availableSchemas.join(', ')));
     }
     return schemaName;
 }
@@ -48,7 +49,7 @@ export function writeChangeMetadata(changeDir, metadata, projectRoot) {
     // Validate with Zod
     const parseResult = ChangeMetadataSchema.safeParse(metadata);
     if (!parseResult.success) {
-        throw new ChangeMetadataError(`Invalid metadata: ${parseResult.error.message}`, metaPath);
+        throw new ChangeMetadataError(CHANGE_METADATA_MESSAGES.invalidMetadata(parseResult.error.message), metaPath);
     }
     // Write YAML file
     const content = yaml.stringify(parseResult.data);
@@ -57,7 +58,7 @@ export function writeChangeMetadata(changeDir, metadata, projectRoot) {
     }
     catch (err) {
         const ioError = err instanceof Error ? err : new Error(String(err));
-        throw new ChangeMetadataError(`Failed to write metadata: ${ioError.message}`, metaPath, ioError);
+        throw new ChangeMetadataError(CHANGE_METADATA_MESSAGES.failedToWriteMetadata(ioError.message), metaPath, ioError);
     }
 }
 /**
@@ -79,7 +80,7 @@ export function readChangeMetadata(changeDir, projectRoot) {
     }
     catch (err) {
         const ioError = err instanceof Error ? err : new Error(String(err));
-        throw new ChangeMetadataError(`Failed to read metadata: ${ioError.message}`, metaPath, ioError);
+        throw new ChangeMetadataError(CHANGE_METADATA_MESSAGES.failedToReadMetadata(ioError.message), metaPath, ioError);
     }
     let parsed;
     try {
@@ -87,17 +88,17 @@ export function readChangeMetadata(changeDir, projectRoot) {
     }
     catch (err) {
         const parseError = err instanceof Error ? err : new Error(String(err));
-        throw new ChangeMetadataError(`Invalid YAML in metadata file: ${parseError.message}`, metaPath, parseError);
+        throw new ChangeMetadataError(CHANGE_METADATA_MESSAGES.invalidYaml(parseError.message), metaPath, parseError);
     }
     // Validate with Zod
     const parseResult = ChangeMetadataSchema.safeParse(parsed);
     if (!parseResult.success) {
-        throw new ChangeMetadataError(`Invalid metadata: ${parseResult.error.message}`, metaPath);
+        throw new ChangeMetadataError(CHANGE_METADATA_MESSAGES.invalidMetadata(parseResult.error.message), metaPath);
     }
     // Validate that the schema exists
     const availableSchemas = listSchemas(projectRoot);
     if (!availableSchemas.includes(parseResult.data.schema)) {
-        throw new ChangeMetadataError(`Unknown schema '${parseResult.data.schema}'. Available: ${availableSchemas.join(', ')}`, metaPath);
+        throw new ChangeMetadataError(CHANGE_METADATA_MESSAGES.unknownSchema(parseResult.data.schema, availableSchemas.join(', ')), metaPath);
     }
     return parseResult.data;
 }

package/dist/utils/change-utils.js

@@ -2,6 +2,7 @@ import path from 'path';
 import { FileSystemUtils } from './file-system.js';
 import { writeChangeMetadata, validateSchemaName } from './change-metadata.js';
 import { readProjectConfig } from '../core/project-config.js';
+import { CHANGE_UTILS_MESSAGES } from '../messages/index.js';
 const DEFAULT_SCHEMA = 'spec-driven';
 /**
  * Validates that a change name follows kebab-case conventions.
@@ -24,35 +25,35 @@ export function validateChangeName(name) {
     // optionally followed by hyphen + lowercase letters/numbers (repeatable)
     const kebabCasePattern = /^[a-z][a-z0-9]*(-[a-z0-9]+)*$/;
     if (!name) {
-        return { valid: false, error: 'Change name cannot be empty' };
+        return { valid: false, error: CHANGE_UTILS_MESSAGES.nameEmpty };
     }
     if (!kebabCasePattern.test(name)) {
         // Provide specific error messages for common mistakes
         if (/[A-Z]/.test(name)) {
-            return { valid: false, error: 'Change name must be lowercase (use kebab-case)' };
+            return { valid: false, error: CHANGE_UTILS_MESSAGES.nameMustBeLowercase };
         }
         if (/\s/.test(name)) {
-            return { valid: false, error: 'Change name cannot contain spaces (use hyphens instead)' };
+            return { valid: false, error: CHANGE_UTILS_MESSAGES.nameNoSpaces };
         }
         if (/_/.test(name)) {
-            return { valid: false, error: 'Change name cannot contain underscores (use hyphens instead)' };
+            return { valid: false, error: CHANGE_UTILS_MESSAGES.nameNoUnderscores };
         }
         if (name.startsWith('-')) {
-            return { valid: false, error: 'Change name cannot start with a hyphen' };
+            return { valid: false, error: CHANGE_UTILS_MESSAGES.nameNoStartHyphen };
         }
         if (name.endsWith('-')) {
-            return { valid: false, error: 'Change name cannot end with a hyphen' };
+            return { valid: false, error: CHANGE_UTILS_MESSAGES.nameNoEndHyphen };
         }
         if (/--/.test(name)) {
-            return { valid: false, error: 'Change name cannot contain consecutive hyphens' };
+            return { valid: false, error: CHANGE_UTILS_MESSAGES.nameNoConsecutiveHyphens };
         }
         if (/[^a-z0-9-]/.test(name)) {
-            return { valid: false, error: 'Change name can only contain lowercase letters, numbers, and hyphens' };
+            return { valid: false, error: CHANGE_UTILS_MESSAGES.nameOnlyAllowedChars };
         }
         if (/^[0-9]/.test(name)) {
-            return { valid: false, error: 'Change name must start with a letter' };
+            return { valid: false, error: CHANGE_UTILS_MESSAGES.nameMustStartWithLetter };
         }
-        return { valid: false, error: 'Change name must follow kebab-case convention (e.g., add-auth, refactor-db)' };
+        return { valid: false, error: CHANGE_UTILS_MESSAGES.nameKebabCase };
     }
     return { valid: true };
 }
@@ -106,7 +107,7 @@ export async function createChange(projectRoot, name, options = {}) {
     const changeDir = path.join(projectRoot, 'openspec', 'changes', name);
     // Check if change already exists
     if (await FileSystemUtils.directoryExists(changeDir)) {
-        throw new Error(`Change '${name}' already exists at ${changeDir}`);
+        throw new Error(CHANGE_UTILS_MESSAGES.changeAlreadyExists(name, changeDir));
     }
     // Create the directory (including parent directories if needed)
     await FileSystemUtils.createDirectory(changeDir);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@dynamicworks/br-openspec",
-  "version": "2.0.0",
+  "version": "2.1.0",
   "description": "AI-native system for spec-driven development",
   "keywords": [
     "openspec",