specifica-br 1.0.0

package/dist/boilerplate/specs-templates/prd-template.md

@@ -0,0 +1,85 @@
+# PRODUCT REQUIREMENTS DOCUMENT (PRD)
+
+| Metadata | Details |
+| :--- | :--- |
+| **Status** | Draft |
+| **Data** | {{DATA_ATUAL}} |
+| **Feature** | [nome-da-funcionalidade] |
+<!-- Status: DRAFT → IN_PROGRESS → APPROVED -->
+
+---
+
+## 1. Contexto e Problema
+**O Problema (Estado Atual):**
+    * [Situação observável e mensurável]
+
+**Causa Raiz (Hipótese):**
+    * [Por que o problema ocorre]
+
+**O Objetivo (Estado Futuro):**
+    * [Mudança observável após a feature]
+
+---
+
+## 2. Escopo
+
+### 2.1. O que Faremos (In-Scope)
+* [ ] Item de escopo 1
+
+### 2.2. O que NÃO Faremos (Out-of-Scope)
+* [ ] Funcionalidade futura X
+* [ ] Definições de arquitetura técnica (ex: Schema de Banco, Endpoints de API)
+
+** Regra de Escopo**: Qualquer item não listado explicitamente em "O que Faremos" deve ser considerado fora do escopo.
+
+---
+
+## 3. Personas e User Stories
+
+| [UserStoryID] | **[Persona]** | [Ação] | [Benefício] |
+| :--- | :--- | :--- | :--- |
+|US-001 | Contador  | Lançamento de Débito| Seja cadastrado com sucesso |
+
+**Cada User Story deve resultar em pelo menos um Requisito Funcional.**
+
+---
+
+## 4. Requisitos Funcionais e Regras de Negócio
+### 4.1. Regras Principais (Happy Path)
+* **[RF-001] Nome do Requisito:**
+    * **Comportamento:** [Descrição detalhada do comportamento esperado]
+    * **Critério:** [Regra de negócio explícita]
+    * **Fonte:** [US-001, US-002]
+
+### 4.2. Validações e Restrições
+* **[RF-003] Validação de Input:**
+    * O sistema deve rejeitar entradas que... [Descreva a regra]
+
+---
+
+## 5. Fluxos de Exceção e Tratamento de Erros (Unhappy Path)
+| Cenário de Erro | Severidade | Comportamento do Sistema | Mensagem |
+| :--- | :--- | :--- |
+| **[Ex: Input Inválido]** | [Bloquear envio] | ["O campo X é obrigatório"] |
+
+---
+
+## 6. Requisitos Não-Funcionais (Qualidade)
+* **[RNF-001] Performance:** [Ex: O carregamento não deve exceder 2 segundos]
+**Apenas Requisitos Não-Funcionais explicitamente listados aqui devem ser considerados.**
+
+---
+
+## 7. Itens em Aberto e Dúvidas (TBD)
+| ID | Questão / Dúvida | Quem deve responder? | Impacto |
+| :--- | :--- | :--- | :--- |
+| **[TBD-001]** | [Ex: Qual o texto final da mensagem de erro?] | [Marketing/Legal] | [Baixo - Apenas Copywriting] |
+
+---
+
+## 8. Critérios de Aceite (Definition of Done)
+Para considerar esta feature concluída, o sistema deve:
+1. [ ] Cumprir todos os Requisitos Funcionais listados.
+2. [ ] Tratar graciosamente todos os Fluxos de Exceção listados.
+3. [ ] Não haver Itens em Aberto (TBD) com impacto "Alto" ou "Bloqueante".
+** A feature só pode ser considerada concluída se todos os RF-XXX e RNF-XXX associados estiverem marcados como atendidos. **

package/dist/boilerplate/specs-templates/task-template.md

@@ -0,0 +1,123 @@
+# Task: {{TASK_ID}} - {{TASK_TITLE}}
+
+| Metadata | Details |
+| :--- | :--- |
+| **Status** | [TODO | IN_PROGRESS | DONE] |
+| **Data** | {{DATA_ATUAL}} |
+| **Task** | {{TASK_TITLE}} |
+| **Feature** | [nome-da-funcionalidade] |
+| **Referência PRD** | [Link PRD](@specs/features/[nome-da-funcionalidade]/prd.md) |]
+| **Referência Tech Spec** | [Link PRD](@specs/features/[nome-da-funcionalidade]/techspec.md) |
+<!-- Status: TODO → IN_PROGRESS → DONE -->
+
+
+## 1. Contexto e Objetivo
+{{CONTEXT_CONTENT}}
+<!-- 
+Regras:
+    - Não reinterpretar requisitos
+    - Não adicionar objetivos não explicitados no PRD
+    - Usar este contexto apenas como orientação de execução 
+-->
+
+---
+
+## 2. Requisitos da Tarefa
+### 2.1 Funcionais (Comportamento)
+<!-- Cada requisito DEVE mapear 1:1 com o PRD -->
+- [ ] (PRD-REQ-01) ...
+- [ ] (PRD-REQ-02) ...
+
+### 2.2 Técnicos (Implementação)
+- [ ] Seguir APENAS os padrões definidos na seção {{ITEM_REF}} do techspec.md
+- [ ] Utilizar exclusivamente as bibliotecas listadas abaixo:
+{{LIBS_LIST}}
+<!-- Proibido adicionar novas dependências -->
+- [ ] Tratamento de erros conforme padrão do projeto.
+
+---
+
+## 3. Plano de Execução (Sub-tarefas)
+<!-- Regras de Execução:
+- Os passos DEVEM ser executados em ordem
+- Um passo só pode ser marcado como concluído se os arquivos-alvo forem alterados
+- Não avançar para o próximo passo se houver erro 
+-->
+
+- [ ] **Passo 1: Estruturas de Dados e Contratos**
+    - *Ação:* Criar interfaces, DTOs, Enums ou Tabelas.
+    - *Arquivos Alvo:* `{{TARGET_FILES_STEP_1}}`
+    - *Critério de Saída:* Código compilável + tipos acessíveis pelos passos seguintes
+
+- [ ] **Passo 2: Implementação da Lógica de Negócio**
+    - *Ação:* Implementar o algoritmo, regra de negócio ou fluxo principal.
+    - *Arquivos Alvo:* `{{TARGET_FILES_STEP_2}}`
+    - *Critério de Saída:* Código compilável + tipos acessíveis pelos passos seguintes
+
+- [ ] **Passo 3: Integração e Exposição**
+    - *Ação:* Conectar a lógica a APIs, UI, CLI ou Banco de Dados.
+    - *Arquivos Alvo:* `{{TARGET_FILES_STEP_3}}`
+    - *Critério de Saída:* Código compilável + tipos acessíveis pelos passos seguintes
+
+- [ ] **Passo 4: Testes e Validação**
+    - *Ação:* Criar testes unitários ou de integração para garantir o funcionamento.
+    - *Arquivos Alvo:* `{{TARGET_FILES_STEP_4}}`
+    - *Critério de Saída:* Código compilável + tipos acessíveis pelos passos seguintes
+
+---
+
+## 4. Detalhes de Implementação & Snippets
+<!-- 
+Os exemplos abaixo são CONTRATOS.
+A implementação final DEVE respeitar forma e assinatura. 
+-->
+
+* **Nomenclatura Esperada:** `{{NAMING_CONVENTION}}`
+* **Estrutura de Input (Exemplo):**
+    ```json
+    {{INPUT_EXAMPLE}}
+    ```
+* **Assinaturas/Interfaces Chave:**
+    ```csharp
+    {{CODE_SIGNATURE_EXAMPLE}}
+    ```
+* **Restrições:**
+- Não alterar assinaturas públicas
+- Não introduzir parâmetros opcionais não documentados
+
+---
+
+## 5. Contexto de Arquivos (File Context)
+<!-- O modelo está AUTORIZADO a ler SOMENTE os arquivos listados abaixo -->
+### 5.1 Arquivos de Leitura (Referência/Exemplos)
+- `@spec/features/[nome-da-funcionalidade]/prd.md`
+- `@spec/features/[nome-da-funcionalidade]/techspec.md`
+- `{{EXAMPLE_FILE_PATH}}` (Exemplo de código existente similar)
+
+### 5.2 Arquivos Permitidos para Escrita (Alvos)
+- `{{TARGET_FILE_A}}`
+- `{{TARGET_FILE_B}}`
+- `{{TARGET_FILE_C}}`
+
+---
+
+## 6. Critérios de Aceite (Definition of Done)
+- [ ] O código compila/executa sem erros de sintaxe.
+- [ ] Todos os requisitos funcionais da seção 2.1 foram atendidos.
+- [ ] Os testes (Passo 4) foram criados e estão passando.
+- [ ] Não há trechos de código comentados ou "TODOs" residuais.
+- [ ] A implementação respeita a arquitetura descrita no `@spec/features/[nome-da-funcionalidade]/techspec.md`.
+- [ ] Todos os passos da seção 3 estão marcados como concluídos
+- [ ] Esta task foi marcada como DONE no arquivo `./spec/features/[nome-da-funcionalidade]/tasks.md` <!-- O modelo DEVE atualizar este arquivo -->
+
+### 6.1 Efeitos Colaterais Obrigatórios
+- [ ] Status da task atualizado para DONE
+- [ ] `./spec/features/[nome-da-funcionalidade]/tasks.md` atualizado corretamente
+
+---
+
+## 7. Arquivos Relevantes (Obrigatório)
+[Listar os arquivos relatantes (arquivos da aplicação, documentações, etc) para a execução da tarefa]
+
+## 8. Notas de Execução (Scratchpad)
+[Uso para decisões técnicas relevantes. Não repetir informações já documentadas]

package/dist/boilerplate/specs-templates/tasks-template.md

@@ -0,0 +1,7 @@
+# Lista de tarefas da funcionalidade [nome-da-funcionalidade]
+
+## Tarefas
+ [ ] 1.0 - Título da Tarefa Principal
+ [ ] 2.0 - Título da Tarefa Principal
+ [ ] 3.0 - Título da Tarefa Principal
+  ... 

package/dist/boilerplate/specs-templates/techspec-template.md

@@ -0,0 +1,168 @@
+# Technical Specification: {{FEATURE_NAME}}
+**Scope:** Esta especificação cobre APENAS a feature {{FEATURE_NAME}} conforme descrita no PRD.
+Qualquer comportamento fora deste escopo deve ser explicitamente rejeitado.
+
+| Metadata | Details |
+| :--- | :--- |
+| **Status** | Draft |
+| **Data** | {{DATA_ATUAL}} |
+| **Referência PRD** | [Link PRD](@specs/features/[nome-da-funcionalidade]/prd.md) |
+<!-- Status: DRAFT → IN_PROGRESS → APPROVED -->
+
+---
+
+## 1. Introdução e contexto
+**Exemplo de Estilo:**
+"Esta feature implementará o fluxo de checkout utilizando o padrão Saga para orquestração. Utilizaremos uma fila (RabbitMQ) para processamento assíncrono de pagamentos para garantir resiliência, e o estado do pedido será persistido no PostgreSQL."
+
+{{INTRODUCTION_CONTENT}}
+
+- **Objetivo de Negócio:** ...
+- **Impacto no Usuário:** ...
+- **Non Goals:** ...
+- **Pressupostos:** ...
+
+---
+
+## 2. High-Level Architecture [Obrigatório]
+### 2.1 Context Diagram
+ **Exemplo:**
+:::mermaid
+ graph LR
+     User -->|HTTP Request| API
+     API -->|Publish Event| MessageBroker
+     Worker -->|Consume| MessageBroker
+     Worker -->|Write| Database
+:::
+<!-- 
+Regras:
+- O diagrama deve refletir APENAS os componentes mencionados no PRD.
+- Serviços especulativos não são permitidos.
+- Prefira menos nós à completude.
+-->
+
+{{CONTEXT_DIAGRAM_CONTENT}}
+
+### 2.3 Design de Componentes (Alinhado com a Arquitetura da Aplicação) [Obrigatório]
+
+**Regras:**
+- Todo componente **DEVE** estar em conformidade com a arquitetura declarada.
+- Todo componente **DEVE** pertencer a **exatamente uma** camada arquitetural.
+- Nenhum componente **PODE** violar a direção das dependências.
+
+**Formato Obrigatório:**
+- **Nome:**
+- **Camada:** Domain | Application | Infrastructure | Interface
+- **Tipo:** Controller | UseCase | DomainService | Repository | Adapter | Worker
+- **Responsabilidade:**
+- **Dependências (Apenas Permitidas):**
+
+{{COMPONENT_DESIGN_CONTENT}}
+
+---
+
+## 3. Design e Persistência de Dados [Se aplicável]
+### 3.1 Modelos de dados / Schema [Se aplicável]
+ **Exemplo (Formato Esperado):**
+ **Entity: Order**
+ - `id` (UUID, PK): Identificador único.
+ - `customer_id` (String, Indexed): Referência ao usuário.
+ - `total_amount` (Decimal, Not Null): Valor final.
+ - `status` (Enum): [PENDING, PAID, FAILED].
+
+{{DATA_MODELS_CONTENT}}
+
+### 3.2 Estratégia de armazenamento [Se aplicável]
+{{STORAGE_STRATEGY_CONTENT}}
+
+---
+
+## 4. Especificações da interface (Contracts) [Se aplicável]
+### 4.1 Public Interfaces
+ **Exemplo (API REST):**
+ **POST /api/v1/orders**
+ - **Input:** `{ "items": [{"id": "xyz", "qty": 1}] }`
+ - **Output (201):** `{ "orderId": "abc-123", "status": "PENDING" }`
+ - **Error (422):** `{ "code": "INVALID_STOCK", "message": "Item xyz out of stock" }`
+
+{{PUBLIC_INTERFACES_CONTENT}}
+
+### 4.2 Interações internas (Events/Messages) [Se aplicável]
+ **Exemplo (Evento):**
+ **Event: OrderCreated**
+ - **Source:** OrderService
+ - **Payload:** `{ "orderId": "...", "timestamp": "..." }`
+
+{{INTERNAL_INTERACTIONS_CONTENT}}
+
+---
+
+## 5. Lógica de negócios e algoritmos principais [Obrigatório]
+### 5.1 Fluxo principal [Obrigatório]
+ **Exemplo:**
+ 1. Receber requisição de cadastro.
+ 2. **Validação:** Verificar se e-mail já existe no Repositório (Unique Constraint).
+    - *Se existir:* Retornar Erro `UserAlreadyExists`.
+ 3. Hash da senha usando algoritmo definido (ex: Argon2).
+ 4. Salvar usuário no banco com status `ACTIVE`.
+ 5. Publicar evento `UserRegistered` no barramento.
+
+{{MAIN_FLOW_CONTENT}}
+
+### 5.2 Casos extremos [Obrigatório]
+**Exemplo:**
+- **Regra:** Se o valor for > 10.000, exigir aprovação manual (status `REVIEW`).
+- **Retry:** Se o serviço de terceiro falhar (5xx), tentar 3 vezes com backoff exponencial.
+
+{{EDGE_CASES_CONTENT}}
+
+---
+
+## 6. Observability & Operational Readiness [Se aplicável]
+### 6.1 Logging & Tracing
+**Exemplo:**
+- **Level:** ERROR
+- **When:** Falha na validação de cartão.
+- **Context:** Logar `orderId`, `userId` e `errorCode` do gateway. (NUNCA logar o número do cartão).
+<!-- 
+Regra: 
+- Todas as métricas/registros definidos aqui DEVEM ser implementados durante a execução da tarefa.
+-->.
+
+{{LOGGING_CONTENT}}
+
+### 6.2 Métricas (KPIs) [Se aplicável]
+**Exemplo:**
+- `payment_gateway_latency_seconds` (Histogram): Tempo de resposta do parceiro.
+- `orders_created_total` (Counter): Volume de vendas.
+
+{{METRICS_CONTENT}}
+
+---
+
+## 7. Segurança & Compliance [Se aplicável]
+**Exemplo:**
+- **Auth:** Endpoint requer token Bearer com role `admin`.
+- **Data Privacy:** O campo `cpf` deve ser criptografado em repouso (At Rest).
+- **Sanitization:** Todos os inputs de texto devem ser sanitizados para evitar XSS/Injection.
+- **Criticidade:** ...
+- **Recomendação:** ...
+- **Fora do escopo:** ...
+
+{{SECURITY_CONTENT}}
+
+---
+
+## 8. Plano de Implementação [Obrigatório]
+**Exemplo:**
+1. Criar migration da tabela `orders`.
+2. Implementar `OrderRepository` e testes de integração.
+3. Implementar Caso de Uso `CreateOrder` (Lógica).
+4. Criar Endpoint na API e DTOs.
+5. Configurar instrumentação de métricas.
+<!-- 
+Regra:
+ - Não mais que 10 passos
+-->
+
+{{IMPLEMENTATION_PLAN_CONTENT}}

package/dist/commands/help.d.ts

@@ -0,0 +1,5 @@
+import { Command } from 'commander';
+/**
+ * Exporta o comando help configurado para uso no Commander.js.
+ */
+export declare const helpCommand: Command;

package/dist/commands/help.js

@@ -0,0 +1,76 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.helpCommand = void 0;
+const commander_1 = require("commander");
+const chalk_1 = __importDefault(require("chalk"));
+/**
+ * Exibe o workflow completo de Spec Driven Development (SDD).
+ * Mostra o fluxo detalhado desde a inicialização até a execução de tarefas.
+ */
+function showCompleteHelp() {
+    console.log('');
+    console.log(chalk_1.default.cyan.bold('Workflow Completo de Spec Driven Development (SDD)'));
+    console.log('');
+    console.log(chalk_1.default.yellow('1. Inicialização:'));
+    console.log(chalk_1.default.white('   $ specifica init'));
+    console.log(chalk_1.default.gray('   Cria estrutura de diretórios e templates no projeto.'));
+    console.log('');
+    console.log(chalk_1.default.yellow('2. Geração de PRD:'));
+    console.log(chalk_1.default.white('   /gerar-prd [sua ideia]'));
+    console.log(chalk_1.default.gray('   Define requisitos funcionais e regras de negócio da feature.'));
+    console.log('');
+    console.log(chalk_1.default.yellow('3. Geração de Tech Spec:'));
+    console.log(chalk_1.default.white('   /gerar-techspec [caminho do prd]'));
+    console.log(chalk_1.default.gray('   Define arquitetura técnica, componentes e plano de implementação.'));
+    console.log('');
+    console.log(chalk_1.default.yellow('4. Geração de Tarefas:'));
+    console.log(chalk_1.default.white('   /gerar-tasks [caminho do prd] [caminho do tech spec]'));
+    console.log(chalk_1.default.gray('   Decompõe o plano técnico em tarefas executáveis.'));
+    console.log('');
+    console.log(chalk_1.default.yellow('5. Execução de Tarefas:'));
+    console.log(chalk_1.default.white('   /executar-task [caminho da task] [prd] [tech spec]'));
+    console.log(chalk_1.default.gray('   Implementa cada tarefa individualmente seguindo a especificação.'));
+    console.log('');
+    console.log(chalk_1.default.cyan.bold('Benefícios do SDD:'));
+    console.log('');
+    console.log(chalk_1.default.white('  • Documentação antes do código'));
+    console.log(chalk_1.default.white('  • Redução de retrabalho'));
+    console.log(chalk_1.default.white('  • Comunicação alinhada entre times'));
+    console.log('');
+}
+/**
+ * Função principal do comando help.
+ * Exibe ajuda simplificada ou completa baseada na flag --completo.
+ */
+function runHelpCommand(options) {
+    if (options.completo) {
+        showCompleteHelp();
+    }
+    else {
+        console.log('');
+        console.log(chalk_1.default.cyan.bold('Usage:'));
+        console.log(chalk_1.default.white('  specifica-br [options] [command]'));
+        console.log('');
+        console.log(chalk_1.default.cyan.bold('Options:'));
+        console.log(chalk_1.default.white('  -V, --version     output the version number'));
+        console.log(chalk_1.default.white('  -h, --help        display help for command'));
+        console.log('');
+        console.log(chalk_1.default.cyan.bold('Commands:'));
+        console.log(chalk_1.default.white('  init              Inicializa estrutura SDD no projeto atual'));
+        console.log(chalk_1.default.white('  help [command]    display help for command'));
+        console.log(chalk_1.default.white('  upgrade           Atualiza templates e comandos (em breve)'));
+        console.log('');
+        console.log(chalk_1.default.gray('Para ajuda detalhada, use: specifica-br help --completo'));
+        console.log('');
+    }
+}
+/**
+ * Exporta o comando help configurado para uso no Commander.js.
+ */
+exports.helpCommand = new commander_1.Command('help')
+    .description('Exibe ajuda dos comandos disponíveis')
+    .option('--completo', 'Exibe ajuda detalhada com workflow completo')
+    .action(runHelpCommand);

package/dist/commands/init.d.ts

@@ -0,0 +1,2 @@
+import { Command } from 'commander';
+export declare const initCommand: Command;

package/dist/commands/init.js

@@ -0,0 +1,70 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.initCommand = void 0;
+const commander_1 = require("commander");
+const prompts_1 = __importDefault(require("prompts"));
+const file_service_1 = require("../utils/file-service");
+const message_formatter_1 = require("../utils/message-formatter");
+async function runInitCommand() {
+    console.log('');
+    console.log('Inicializando estrutura Spec Driven Development...');
+    console.log('');
+    try {
+        const toolResponse = await (0, prompts_1.default)({
+            type: 'select',
+            name: 'tool',
+            message: 'Selecione a ferramenta de IA:',
+            choices: [
+                { title: 'OpenCode', value: 'opencode' }
+            ],
+            initial: 0
+        });
+        if (!toolResponse.tool) {
+            (0, message_formatter_1.showErrorMessage)('Operação cancelada pelo usuário.');
+            process.exit(1);
+        }
+        const modelResponse = await (0, prompts_1.default)({
+            type: 'select',
+            name: 'model',
+            message: 'Selecione o modelo de IA:',
+            choices: [
+                { title: 'GLM 4.7', value: 'glm-4.7' }
+            ],
+            initial: 0
+        });
+        if (!modelResponse.model) {
+            (0, message_formatter_1.showErrorMessage)('Operação cancelada pelo usuário.');
+            process.exit(1);
+        }
+        const answers = {
+            tool: toolResponse.tool,
+            model: modelResponse.model
+        };
+        console.log('');
+        (0, message_formatter_1.showInfoMessage)(`Ferramenta: ${answers.tool} | Modelo: ${answers.model}`);
+        console.log('');
+        (0, message_formatter_1.showInfoMessage)('Criando estrutura de diretórios...');
+        (0, file_service_1.createDirectories)();
+        console.log('');
+        (0, message_formatter_1.showInfoMessage)('Copiando arquivos de templates...');
+        (0, file_service_1.copyTemplates)();
+        (0, message_formatter_1.showSuccessMessage)();
+        (0, message_formatter_1.showMissionMessage)();
+        process.exit(0);
+    }
+    catch (error) {
+        if (error instanceof Error) {
+            (0, message_formatter_1.showErrorMessage)(error.message);
+        }
+        else {
+            (0, message_formatter_1.showErrorMessage)('Erro desconhecido ao executar comando init.');
+        }
+        process.exit(1);
+    }
+}
+exports.initCommand = new commander_1.Command('init')
+    .description('Inicializa estrutura SDD no projeto atual')
+    .action(runInitCommand);

package/dist/commands/upgrade.d.ts

@@ -0,0 +1,5 @@
+import { Command } from 'commander';
+/**
+ * Exporta o comando upgrade configurado para uso no Commander.js.
+ */
+export declare const upgradeCommand: Command;

package/dist/commands/upgrade.js

@@ -0,0 +1,24 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.upgradeCommand = void 0;
+const commander_1 = require("commander");
+const chalk_1 = __importDefault(require("chalk"));
+/**
+ * Função principal do comando upgrade.
+ * Exibe mensagem informativa sobre o comando em desenvolvimento.
+ */
+function runUpgradeCommand() {
+    console.log('');
+    console.log(chalk_1.default.yellow('Comando em desenvolvimento.'));
+    console.log(chalk_1.default.gray('Em breve você poderá atualizar templates e comandos automaticamente.'));
+    console.log('');
+}
+/**
+ * Exporta o comando upgrade configurado para uso no Commander.js.
+ */
+exports.upgradeCommand = new commander_1.Command('upgrade')
+    .description('Atualiza templates e comandos (em breve)')
+    .action(runUpgradeCommand);

package/dist/index.d.ts

@@ -0,0 +1,2 @@
+#!/usr/bin/env node
+export {};

package/dist/index.js

@@ -0,0 +1,16 @@
+#!/usr/bin/env node
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const commander_1 = require("commander");
+const init_1 = require("./commands/init");
+const help_1 = require("./commands/help");
+const upgrade_1 = require("./commands/upgrade");
+const program = new commander_1.Command();
+program
+    .name('specifica-br')
+    .description('Ferramenta de automação para desenvolvimento guiado por especificações (Spec Driven Development - SDD) com IA. Otimizado para o ecossistema brasileiro.')
+    .version('1.0.0');
+program.addCommand(init_1.initCommand);
+program.addCommand(help_1.helpCommand);
+program.addCommand(upgrade_1.upgradeCommand);
+program.parse(process.argv);

package/dist/types/init.d.ts

@@ -0,0 +1,19 @@
+/**
+ * Interface para as respostas do comando init.
+ * Representa as escolhas do usuário durante o fluxo interativo.
+ */
+export interface InitAnswers {
+    tool: string;
+    model: string;
+}
+/**
+ * Interface para configuração de templates.
+ * Mapeia ferramentas e modelos para os paths de arquivos de comando.
+ */
+export interface TemplateConfig {
+    [key: string]: {
+        tool: string;
+        model: string;
+        opencodeCommands: string[];
+    };
+}

package/dist/types/init.js

@@ -0,0 +1,2 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });

package/dist/utils/file-service.d.ts

@@ -0,0 +1,2 @@
+export declare function createDirectories(): void;
+export declare function copyTemplates(): void;