specifica-br 1.0.3 → 1.1.0

package/README.md

@@ -95,13 +95,224 @@ specifica-br help --completo
 
 ### `specifica-br upgrade`
 
-Atualiza templates e comandos (em breve).
+Atualiza a CLI para a versão mais recente do NPM.
 
 ```bash
 specifica-br upgrade
 ```
 
-**Nota:** Este comando está em desenvolvimento e estará disponível em uma versão futura.
+#### Requisitos
+
+- **npm instalado:** O comando npm deve estar disponível no sistema
+- **Permissões:** Dependendo do sistema operacional, pode ser necessário executar com permissões elevadas
+
+#### Instruções por Plataforma
+
+**Windows:**
+
+- Execute o comando normalmente
+- Se receber erro de permissão, clique com botão direito no terminal/CMD e selecione "Executar como administrador"
+- Alternativamente, abra PowerShell como administrador e execute o comando
+
+**Linux:**
+
+- Execute o comando normalmente
+- Se receber erro de permissão, use `sudo`:
+  ```bash
+  sudo specifica-br upgrade
+  ```
+
+**MacOS:**
+
+- Execute o comando normalmente
+- Se receber erro de permissão, use `sudo`:
+  ```bash
+  sudo specifica-br upgrade
+  ```
+
+#### Exemplos
+
+**Atualização bem-sucedida:**
+
+```bash
+$ specifica-br upgrade
+
+Verificando instalação do npm...
+
+✓ npm encontrado.
+
+Atualizando specifica-br para a versão mais recente...
+Executando: npm i -g specifica-br@latest
+
+[output do npm]
+
+✓ specifica-br atualizado com sucesso!
+```
+
+**Erro de permissão no Windows:**
+
+```bash
+$ specifica-br upgrade
+
+✗ Permissão negada.
+Execute como administrador (clique com botão direito > Executar como administrador)
+```
+
+**Erro de permissão no Linux/MacOS:**
+
+```bash
+$ specifica-br upgrade
+
+✗ Permissão negada.
+Execute: sudo specifica-br upgrade
+```
+
+**npm não encontrado:**
+
+```bash
+$ specifica-br upgrade
+
+✗ npm não encontrado.
+Instale Node.js e npm em: https://nodejs.org
+```
+
+#### Logs
+
+Em caso de erro, um log detalhado será gerado no diretório `/logs` do pacote, com formato `log_yyyy_MM_dd_hh_mm_ss.txt`. O caminho completo do log será exibido na mensagem de erro.
+
+**Caminhos de Log por Plataforma:**
+
+- **Windows:** `C:\Users\[usuario]\AppData\Roaming\npm\node_modules\specifica-br\logs\log_2026_02_18_14_30_15.txt`
+- **Linux/MacOS:** `/usr/local/lib/node_modules/specifica-br/logs/log_2026_02_18_14_30_15.txt` (ou caminho semelhante, dependendo da instalação)
+
+## Sistema de Notificações de Atualização
+
+A CLI `specifica-br` verifica automaticamente se há atualizações disponíveis no NPM durante a execução dos comandos habilitados.
+
+### Como Funciona
+
+1. Ao executar um comando habilitado (ex: `init`, `help`, `upgrade`), a CLI verifica se existe uma versão mais recente no NPM
+2. A verificação é assíncrona e não afeta o tempo de execução do comando
+3. Se uma nova versão estiver disponível, uma notificação será exibida ao final do output
+4. Funciona em Windows, Linux e MacOS
+
+### Notificação de Atualização
+
+Quando uma nova versão estiver disponível, você verá uma mensagem como esta:
+
+```
+ Update disponível 
+
+1.0.0 → 1.1.0
+
+Run specifica-br upgrade (em algum projeto)
+Run npm i -g specifica-br para atualizar
+```
+
+### Comandos que Exibem Notificações
+
+Por padrão, os seguintes comandos verificam atualizações:
+- `init` - Inicializa estrutura SDD
+- `help` - Exibe informações de ajuda
+- `upgrade` - Atualiza a CLI
+
+**Nota:** A lista de comandos pode ser configurada editando o arquivo `settings.json`.
+
+### Configuração de Comandos Habilitados
+
+Você pode configurar quais comandos da CLI devem verificar atualizações editando o arquivo de configuração.
+
+#### Arquivo de Configuração
+
+O arquivo `settings.json` está localizado no diretório `assets` do pacote.
+
+**Caminho por Plataforma:**
+
+- **Desenvolvimento:** `src/assets/settings.json` (no diretório do projeto)
+- **Instalação Global:**
+  - **Windows:** `C:\Users\[usuario]\AppData\Roaming\npm\node_modules\specifica-br\dist\assets\settings.json`
+  - **Linux:** `/usr/local/lib/node_modules/specifica-br/dist/assets/settings.json`
+  - **MacOS:** `/usr/local/lib/node_modules/specifica-br/dist/assets/settings.json`
+
+#### Estrutura do Arquivo
+
+```json
+{
+  "enabledUpgradeCommands": ["init", "help", "upgrade"]
+}
+```
+
+#### Modificando a Configuração
+
+**Para habilitar verificação em um comando:**
+
+Adicione o nome do comando ao array `enabledUpgradeCommands`:
+
+```json
+{
+  "enabledUpgradeCommands": ["init", "help", "upgrade", "generate"]
+}
+```
+
+**Para desabilitar verificação em um comando:**
+
+Remova o nome do comando do array `enabledUpgradeCommands`:
+
+```json
+{
+  "enabledUpgradeCommands": ["init", "help"]
+}
+```
+
+**Para desabilitar todas as verificações:**
+
+Use um array vazio:
+
+```json
+{
+  "enabledUpgradeCommands": []
+}
+```
+
+#### Editando o Arquivo de Configuração
+
+**Windows (PowerShell):**
+```powershell
+notepad "C:\Users\[usuario]\AppData\Roaming\npm\node_modules\specifica-br\dist\assets\settings.json"
+```
+
+**Windows (CMD):**
+```cmd
+notepad "C:\Users\[usuario]\AppData\Roaming\npm\node_modules\specifica-br\dist\assets\settings.json"
+```
+
+**Linux/MacOS (Nano):**
+```bash
+nano /usr/local/lib/node_modules/specifica-br/dist/assets/settings.json
+```
+
+**Linux/MacOS (Vim):**
+```bash
+vi /usr/local/lib/node_modules/specifica-br/dist/assets/settings.json
+```
+
+**Nota:** Dependendo de como o npm está configurado, o caminho de instalação pode variar. Execute `npm root -g` para verificar o caminho global de node_modules no seu sistema.
+
+#### Fallback
+
+Se o arquivo `settings.json` não for encontrado ou estiver inválido, a CLI usará a configuração padrão:
+```json
+{
+  "enabledUpgradeCommands": ["init", "help", "upgrade"]
+}
+```
+
+### Compatibilidade
+
+Este sistema funciona nativamente em todos os sistemas operacionais:
+- ✅ Windows (10, 11)
+- ✅ Linux (Ubuntu, Debian, Fedora, etc.)
+- ✅ MacOS (todas as versões suportadas pelo Node.js)
 
 ## Workflow SDD Completo
 

package/dist/commands/help.js

@@ -1,44 +1,39 @@
-"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"));
+import { Command } from 'commander';
+import chalk from 'chalk';
+import { updateNotifierMiddleware } from '../utils/update-notifier-middleware.js';
 /**
  * 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(chalk.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(chalk.yellow('1. Inicialização:'));
+    console.log(chalk.white('   $ specifica init'));
+    console.log(chalk.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(chalk.yellow('2. Geração de PRD:'));
+    console.log(chalk.white('   /gerar-prd [sua ideia]'));
+    console.log(chalk.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(chalk.yellow('3. Geração de Tech Spec:'));
+    console.log(chalk.white('   /gerar-techspec [caminho do prd]'));
+    console.log(chalk.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(chalk.yellow('4. Geração de Tarefas:'));
+    console.log(chalk.white('   /gerar-tasks [caminho do prd] [caminho do tech spec]'));
+    console.log(chalk.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(chalk.yellow('5. Execução de Tarefas:'));
+    console.log(chalk.white('   /executar-task [caminho da task] [prd] [tech spec]'));
+    console.log(chalk.gray('   Implementa cada tarefa individualmente seguindo a especificação.'));
     console.log('');
-    console.log(chalk_1.default.cyan.bold('Benefícios do SDD:'));
+    console.log(chalk.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(chalk.white('  • Documentação antes do código'));
+    console.log(chalk.white('  • Redução de retrabalho'));
+    console.log(chalk.white('  • Comunicação alinhada entre times'));
     console.log('');
 }
 /**
@@ -51,26 +46,29 @@ function runHelpCommand(options) {
     }
     else {
         console.log('');
-        console.log(chalk_1.default.cyan.bold('Usage:'));
-        console.log(chalk_1.default.white('  specifica-br [options] [command]'));
+        console.log(chalk.cyan.bold('Usage:'));
+        console.log(chalk.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(chalk.cyan.bold('Options:'));
+        console.log(chalk.white('  -V, --version     output the version number'));
+        console.log(chalk.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(chalk.cyan.bold('Commands:'));
+        console.log(chalk.white('  init              Inicializa estrutura SDD no projeto atual'));
+        console.log(chalk.white('  help [command]    display help for command'));
+        console.log(chalk.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(chalk.gray('Para ajuda detalhada, use: specifica-br help --completo'));
         console.log('');
     }
 }
+async function wrappedRunHelpCommand(options) {
+    await updateNotifierMiddleware.wrap('help', async () => { runHelpCommand(options); });
+}
 /**
  * Exporta o comando help configurado para uso no Commander.js.
  */
-exports.helpCommand = new commander_1.Command('help')
+export const helpCommand = new Command('help')
     .description('Exibe ajuda dos comandos disponíveis')
     .option('--completo', 'Exibe ajuda detalhada com workflow completo')
-    .action(runHelpCommand);
+    .action(wrappedRunHelpCommand);

package/dist/commands/init.js

@@ -1,70 +1,92 @@
-"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");
+import { Command } from 'commander';
+import prompts from 'prompts';
+import { FileService } from '../utils/file-service.js';
+import { showSuccessMessage, showMissionMessage, showErrorMessage, showInfoMessage } from '../utils/message-formatter.js';
+import { updateNotifierMiddleware } from '../utils/update-notifier-middleware.js';
 async function runInitCommand() {
     console.log('');
     console.log('Inicializando estrutura Spec Driven Development...');
     console.log('');
+    const handleSigInt = () => {
+        console.log('');
+        showErrorMessage('Operação cancelada pelo usuário.');
+        process.exit(1);
+    };
+    const fileService = new FileService();
     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)({
+        process.on('SIGINT', handleSigInt);
+        const directoryConventionResponse = await prompts({
             type: 'select',
-            name: 'model',
-            message: 'Selecione o modelo de IA:',
+            name: 'directoryConvention',
+            message: 'Selecione a convenção de diretórios para comandos:',
             choices: [
-                { title: 'GLM 4.7', value: 'glm-4.7' }
+                { title: 'Recomendado (OpenCode)', value: 'opencode', description: 'Cria diretório .opencode/commands/ para uso com OpenCode' },
+                { title: 'Agnóstico (Specifica-BR)', value: 'specifica-br', description: 'Cria diretório specifica-br/commands/ para uso em qualquer IDE/IA' }
             ],
             initial: 0
         });
-        if (!modelResponse.model) {
-            (0, message_formatter_1.showErrorMessage)('Operação cancelada pelo usuário.');
+        if (!directoryConventionResponse.directoryConvention) {
+            showErrorMessage('Operação cancelada pelo usuário.');
             process.exit(1);
         }
         const answers = {
-            tool: toolResponse.tool,
-            model: modelResponse.model
+            directoryConvention: directoryConventionResponse.directoryConvention
         };
+        if (answers.directoryConvention === 'opencode') {
+            const toolResponse = await prompts({
+                type: 'select',
+                name: 'tool',
+                message: 'Selecione a ferramenta de IA:',
+                choices: [
+                    { title: 'OpenCode', value: 'opencode' }
+                ],
+                initial: 0
+            });
+            if (!toolResponse.tool) {
+                showErrorMessage('Operação cancelada pelo usuário.');
+                process.exit(1);
+            }
+            const modelResponse = await prompts({
+                type: 'select',
+                name: 'model',
+                message: 'Selecione o modelo de IA:',
+                choices: [
+                    { title: 'GLM 4.7', value: 'glm-4.7' }
+                ],
+                initial: 0
+            });
+            if (!modelResponse.model) {
+                showErrorMessage('Operação cancelada pelo usuário.');
+                process.exit(1);
+            }
+            answers.tool = toolResponse.tool;
+            answers.model = modelResponse.model;
+            console.log('');
+            showInfoMessage(`Ferramenta: ${answers.tool} | Modelo: ${answers.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);
+        showInfoMessage('Criando estrutura de diretórios...');
+        console.log(`• Convenção selecionada: ${answers.directoryConvention}`);
+        await fileService.createStructure(answers.directoryConvention);
+        showSuccessMessage(answers.directoryConvention);
+        showMissionMessage();
     }
     catch (error) {
         if (error instanceof Error) {
-            (0, message_formatter_1.showErrorMessage)(error.message);
+            showErrorMessage(error.message);
         }
         else {
-            (0, message_formatter_1.showErrorMessage)('Erro desconhecido ao executar comando init.');
+            showErrorMessage('Erro desconhecido ao executar comando init.');
         }
         process.exit(1);
     }
+    finally {
+        process.off('SIGINT', handleSigInt);
+    }
+}
+async function wrappedRunInitCommand() {
+    await updateNotifierMiddleware.wrap('init', runInitCommand);
 }
-exports.initCommand = new commander_1.Command('init')
+export const initCommand = new Command('init')
     .description('Inicializa estrutura SDD no projeto atual')
-    .action(runInitCommand);
+    .action(wrappedRunInitCommand);

package/dist/commands/upgrade.d.ts

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

package/dist/commands/upgrade.js

@@ -1,24 +1,95 @@
-"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() {
+import { Command } from 'commander';
+import chalk from 'chalk';
+import { exec } from 'child_process';
+import { promisify } from 'util';
+import { platform } from 'os';
+import { logService } from '../utils/log-service.js';
+import { updateNotifierMiddleware } from '../utils/update-notifier-middleware.js';
+const execAsync = promisify(exec);
+function isWindows() {
+    return platform() === 'win32';
+}
+async function checkNpmInstalled() {
+    try {
+        await execAsync('npm --version');
+        return true;
+    }
+    catch (error) {
+        return false;
+    }
+}
+async function runUpgradeCommand() {
+    console.log('');
+    console.log(chalk.cyan('Verificando instalação do npm...'));
     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.'));
+    const npmInstalled = await checkNpmInstalled();
+    if (!npmInstalled) {
+        console.log('');
+        console.log(chalk.red('✗ npm não encontrado.'));
+        console.log(chalk.yellow('Instale Node.js e npm em: https://nodejs.org'));
+        console.log('');
+        process.exit(1);
+    }
+    console.log(chalk.green('✓ npm encontrado.'));
     console.log('');
+    console.log(chalk.cyan('Atualizando specifica-br para a versão mais recente...'));
+    console.log(chalk.gray('Executando: npm i -g specifica-br@latest'));
+    console.log('');
+    try {
+        const { stdout, stderr } = await execAsync('npm i -g specifica-br@latest', {
+            maxBuffer: 1024 * 1024 * 10,
+            shell: true
+        });
+        if (stdout) {
+            console.log(stdout);
+        }
+        if (stderr) {
+            console.log(chalk.yellow(stderr));
+        }
+        console.log('');
+        console.log(chalk.green('✓ specifica-br atualizado com sucesso!'));
+        console.log('');
+    }
+    catch (error) {
+        if (error instanceof Error) {
+            const errorMessage = error.message;
+            if (errorMessage.includes('EACCES') || errorMessage.includes('EPERM')) {
+                console.log('');
+                console.log(chalk.red('✗ Permissão negada.'));
+                if (isWindows()) {
+                    console.log(chalk.yellow('Execute como administrador (clique com botão direito > Executar como administrador)'));
+                }
+                else {
+                    console.log(chalk.yellow('Execute: sudo specifica-br upgrade'));
+                }
+                console.log('');
+                process.exit(1);
+            }
+            console.log('');
+            console.log(chalk.red('✗ Erro ao atualizar specifica-br.'));
+            const logPath = await logService.logError(error, 'UpgradeCommand');
+            console.log(chalk.yellow(`Log detalhado salvo em: ${logPath}`));
+            console.log('');
+            console.log(chalk.cyan('Tente executar manualmente:'));
+            console.log(chalk.gray('  npm i -g specifica-br@latest'));
+            if (isWindows()) {
+                console.log(chalk.gray('  (Execute como administrador se necessário)'));
+            }
+            else {
+                console.log(chalk.gray('  (Use sudo se necessário)'));
+            }
+            console.log('');
+            process.exit(1);
+        }
+        console.log('');
+        console.log(chalk.red('✗ Erro desconhecido ao executar upgrade.'));
+        console.log('');
+        process.exit(1);
+    }
+}
+async function wrappedRunUpgradeCommand() {
+    await updateNotifierMiddleware.wrap('upgrade', runUpgradeCommand);
 }
-/**
- * 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);
+export const upgradeCommand = new Command('upgrade')
+    .description('Atualiza a CLI para a versão mais recente do NPM')
+    .action(wrappedRunUpgradeCommand);

package/dist/index.d.ts

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

package/dist/index.js

@@ -1,22 +1,19 @@
 #!/usr/bin/env node
-"use strict";
-var __importDefault = (this && this.__importDefault) || function (mod) {
-    return (mod && mod.__esModule) ? mod : { "default": mod };
-};
-Object.defineProperty(exports, "__esModule", { value: true });
-const commander_1 = require("commander");
-const fs_extra_1 = __importDefault(require("fs-extra"));
-const path_1 = __importDefault(require("path"));
-const init_1 = require("./commands/init");
-const help_1 = require("./commands/help");
-const upgrade_1 = require("./commands/upgrade");
-const packageJson = JSON.parse(fs_extra_1.default.readFileSync(path_1.default.join(__dirname, '..', 'package.json'), 'utf-8'));
-const program = new commander_1.Command();
+import { Command } from 'commander';
+import fs from 'fs-extra';
+import path from 'path';
+import { fileURLToPath } from 'url';
+import { initCommand } from './commands/init.js';
+import { helpCommand } from './commands/help.js';
+import { upgradeCommand } from './commands/upgrade.js';
+const __dirname = path.dirname(fileURLToPath(import.meta.url));
+const packageJson = JSON.parse(fs.readFileSync(path.join(__dirname, '..', 'package.json'), 'utf-8'));
+const program = new 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(packageJson.version);
-program.addCommand(init_1.initCommand);
-program.addCommand(help_1.helpCommand);
-program.addCommand(upgrade_1.upgradeCommand);
+program.addCommand(initCommand);
+program.addCommand(helpCommand);
+program.addCommand(upgradeCommand);
 program.parse(process.argv);

package/dist/settings.json

@@ -0,0 +1,4 @@
+{
+  "enabledUpgradeCommands": ["init", "upgrade"],
+  "versionCheckTimeoutMs": 1500
+}

package/dist/types/init.d.ts

@@ -3,8 +3,9 @@
  * Representa as escolhas do usuário durante o fluxo interativo.
  */
 export interface InitAnswers {
-    tool: string;
-    model: string;
+    directoryConvention: 'opencode' | 'specifica-br';
+    tool?: string;
+    model?: string;
 }
 /**
  * Interface para configuração de templates.

package/dist/types/init.js

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