@dynamicworks/br-openspec 2.0.1 → 2.1.0

package/schemas/spec-driven/templates/design.md

@@ -1,19 +1,19 @@
 ## Context
 
-<!-- Background and current state -->
+<!-- Contexto e estado atual -->
 
 ## Goals / Non-Goals
 
 **Goals:**
-<!-- What this design aims to achieve -->
+<!-- O que este design pretende alcançar -->
 
 **Non-Goals:**
-<!-- What is explicitly out of scope -->
+<!-- O que está explicitamente fora de escopo -->
 
 ## Decisions
 
-<!-- Key design decisions and rationale -->
+<!-- Principais decisões de design e suas justificativas -->
 
 ## Risks / Trade-offs
 
-<!-- Known risks and trade-offs -->
+<!-- Riscos e trade-offs conhecidos -->

package/schemas/spec-driven/templates/proposal.md

@@ -1,23 +1,23 @@
 ## Why
 
-<!-- Explain the motivation for this change. What problem does this solve? Why now? -->
+<!-- Explique a motivação desta mudança. Qual problema ela resolve? Por que agora? -->
 
 ## What Changes
 
-<!-- Describe what will change. Be specific about new capabilities, modifications, or removals. -->
+<!-- Descreva o que vai mudar. Seja específico sobre novas capacidades, modificações ou remoções. -->
 
 ## Capabilities
 
 ### New Capabilities
-<!-- Capabilities being introduced. Replace <name> with kebab-case identifier (e.g., user-auth, data-export, api-rate-limiting). Each creates specs/<name>/spec.md -->
-- `<name>`: <brief description of what this capability covers>
+<!-- Capacidades sendo introduzidas. Substitua <name> por um identificador kebab-case (ex.: user-auth, data-export, api-rate-limiting). Cada uma cria specs/<name>/spec.md -->
+- `<name>`: <descrição breve do que esta capacidade abrange>
 
 ### Modified Capabilities
-<!-- Existing capabilities whose REQUIREMENTS are changing (not just implementation).
-     Only list here if spec-level behavior changes. Each needs a delta spec file.
-     Use existing spec names from openspec/specs/. Leave empty if no requirement changes. -->
-- `<existing-name>`: <what requirement is changing>
+<!-- Capacidades existentes cujos REQUIREMENTS estão mudando (não apenas a implementação).
+     Liste aqui somente se o comportamento em nível de spec mudar. Cada uma precisa de um arquivo de spec delta.
+     Use nomes de spec existentes de openspec/specs/. Deixe vazio se nenhum requisito mudar. -->
+- `<existing-name>`: <qual requisito está mudando>
 
 ## Impact
 
-<!-- Affected code, APIs, dependencies, systems -->
+<!-- Código, APIs, dependências e sistemas afetados -->

package/schemas/spec-driven/templates/spec.md

@@ -1,8 +1,8 @@
 ## ADDED Requirements
 
-### Requirement: <!-- requirement name -->
-<!-- requirement text -->
+### Requirement: <!-- nome do requisito -->
+<!-- texto do requisito -->
 
-#### Scenario: <!-- scenario name -->
-- **WHEN** <!-- condition -->
-- **THEN** <!-- expected outcome -->
+#### Scenario: <!-- nome do cenário -->
+- **WHEN** <!-- condição -->
+- **THEN** <!-- resultado esperado -->

package/schemas/spec-driven/templates/tasks.md

@@ -1,9 +1,9 @@
-## 1. <!-- Task Group Name -->
+## 1. <!-- Nome do Grupo de Tarefas -->
 
-- [ ] 1.1 <!-- Task description -->
-- [ ] 1.2 <!-- Task description -->
+- [ ] 1.1 <!-- Descrição da tarefa -->
+- [ ] 1.2 <!-- Descrição da tarefa -->
 
-## 2. <!-- Task Group Name -->
+## 2. <!-- Nome do Grupo de Tarefas -->
 
-- [ ] 2.1 <!-- Task description -->
-- [ ] 2.2 <!-- Task description -->
+- [ ] 2.1 <!-- Descrição da tarefa -->
+- [ ] 2.2 <!-- Descrição da tarefa -->

package/dist/core/templates/workflows/upstream-sync.d.ts

@@ -1,10 +0,0 @@
-/**
- * Upstream Sync Workflow Template
- *
- * Guides the process of syncing the BR-OpenSpec fork with the upstream
- * OpenSpec repository, translating new content to Brazilian Portuguese.
- */
-import type { SkillTemplate, CommandTemplate } from '../types.js';
-export declare function getUpstreamSyncSkillTemplate(): SkillTemplate;
-export declare function getOpsxUpstreamSyncCommandTemplate(): CommandTemplate;
-//# sourceMappingURL=upstream-sync.d.ts.map

package/dist/core/templates/workflows/upstream-sync.js

@@ -1,116 +0,0 @@
-/**
- * Upstream Sync Workflow Template
- *
- * Guides the process of syncing the BR-OpenSpec fork with the upstream
- * OpenSpec repository, translating new content to Brazilian Portuguese.
- */
-export function getUpstreamSyncSkillTemplate() {
-    return {
-        name: 'openspec-upstream-sync',
-        description: 'Sincroniza o BR-OpenSpec com o upstream, traduz novas mensagens e atualiza a documentação em português brasileiro. Use quando houver atualizações no repositório original que precisem ser incorporadas ao fork.',
-        instructions: `Sincronize o BR-OpenSpec com o repositório upstream e traduza o conteúdo novo para português brasileiro.
-
-**Entrada**: O usuário indica que há atualizações no upstream ou pede para sincronizar.
-
-**Pré-requisitos**
-- O remote upstream deve estar configurado: 
-  \`git remote add upstream https://github.com/<upstream-owner>/<upstream-repo>.git\` (se ainda não estiver)
-
-**Passos**
-
-1. **Verifique o estado atual**
-   \`\`\`bash
-   git fetch upstream
-   git log --oneline HEAD..upstream/main --no-merges | head -20
-   \`\`\`
-   Isso mostra os commits que serão incorporados.
-
-2. **Crie uma branch para o sync**
-   \`\`\`bash
-   git checkout -b sync/upstream-$(date +%Y%m%d)
-   \`\`\`
-
-3. **Faça o merge do upstream**
-   \`\`\`bash
-   git merge upstream/main --no-edit
-   \`\`\`
-   - Se houver conflitos em \`src/messages/index.ts\`, resolva mantendo as mensagens em português brasileiro e incorporando as novas chaves em inglês.
-   - Para outros arquivos, resolva normalmente preservando as adaptações do BR-OpenSpec.
-
-4. **Identifique novas strings de usuário**
-   Após o merge, encontre strings hardcoded em inglês que ainda não estão no catálogo:
-   \`\`\`bash
-   git diff upstream/main..HEAD --name-only | grep "^src/"
-   \`\`\`
-   Busque por novas ocorrências de \`console.log\`, \`console.error\`, \`console.warn\`, \`.description(\`, \`message:\` em arquivos modificados.
-
-5. **Atualize o catálogo de mensagens**
-   - Adicione novas chaves em \`src/messages/index.ts\` na seção apropriada
-   - Traduza os valores para português brasileiro
-   - Mantenha a organização por domínio (CLI_DESCRIPTIONS, CLI_MESSAGES, CHANGE_MESSAGES, etc.)
-   - Se uma seção nova for necessária, crie-a com o padrão existente
-
-6. **Substitua strings hardcoded nos arquivos fonte**
-   - Substitua cada string em inglês recém-adicionada pela referência ao catálogo
-   - Adicione o import necessário de \`../messages/index.js\` (ou caminho relativo apropriado)
-   - NÃO traduza: nomes de variáveis, comentários de código, identificadores técnicos, nomes de comandos CLI
-
-7. **Atualize menções ao nome do projeto**
-   - Novos textos podem referenciar "OpenSpec" em vez de "BR-OpenSpec"
-   - Substitua referências ao nome do projeto em mensagens de usuário: \`s/\\bOpenSpec\\b/BR-OpenSpec/g\`
-   - NÃO altere: \`openspec\` (comando), \`openspec-\` (prefixos), \`OPENSPEC_\` (constantes), URLs
-
-8. **Sincronize a documentação traduzida**
-   Compare os arquivos de documentação em inglês com seus correspondentes em pt-BR:
-   - \`README.md\` ↔ \`README.pt-BR.md\`
-   - \`docs/*.md\` ↔ \`docs/pt-BR/*.md\`
-   
-   Para cada arquivo modificado pelo upstream:
-   - Aplique as mesmas mudanças estruturais nos correspondentes pt-BR
-   - Traduza novos trechos adicionados pelo upstream
-   - **PRESERVE adições pontuais do fork** (ex: justificativa da criação do fork, referências específicas ao BR-OpenSpec, links para recursos em pt-BR)
-   - Substitua "OpenSpec" por "BR-OpenSpec" quando o texto se referir ao projeto que o usuário está usando
-   - Mantenha nomes técnicos inalterados: \`openspec\`, \`.openspec.yaml\`, \`openspec/\`, skills \`openspec-*\`
-
-9. **Atualize os testes**
-   - Rode \`pnpm test\` para identificar testes que quebraram devido às traduções
-   - Atualize as expectativas de strings de \`test/\` para refletir as mensagens em português
-   - NÃO altere a lógica dos testes — apenas as strings de comparação
-
-10. **Valide o build**
-    \`\`\`bash
-    pnpm run build
-    pnpm exec tsc --noEmit
-    pnpm lint
-    \`\`\`
-
-11. **Resumo do sync**
-    Informe ao usuário:
-    - Quais commits foram incorporados
-    - Quais arquivos foram modificados
-    - Quantas novas mensagens foram traduzidas
-    - Quais arquivos de documentação foram sincronizados
-    - Se há testes ainda falhando (e por quê)
-
-**IMPORTANTE**: NUNCA traduza código técnico (nomes de variáveis, funções, constantes) ou comentários de documentação de API. Apenas mensagens exibidas ao usuário final.
-`,
-    };
-}
-export function getOpsxUpstreamSyncCommandTemplate() {
-    return {
-        name: 'upstream-sync',
-        description: 'Sincroniza com upstream e traduz novidades',
-        category: 'maintenance',
-        tags: ['sync', 'upstream', 'i18n'],
-        content: `Sincronize o BR-OpenSpec com o upstream.
-
-1. Verifique atualizações: \`git fetch upstream && git log --oneline HEAD..upstream/main | head -10\`
-2. Se houver commits, crie branch e faça merge
-3. Identifique e traduza novas strings de usuário
-4. Atualize o catálogo em \`src/messages/index.ts\`
-5. Sincronize a documentação em pt-BR preservando adições do fork
-6. Valide: \`pnpm run build && pnpm test\`
-7. Resuma as mudanças para o usuário`,
-    };
-}
-//# sourceMappingURL=upstream-sync.js.map