specifica-br 1.0.3 → 1.1.1

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", "help", "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 {};

package/dist/types/settings.d.ts

@@ -0,0 +1,9 @@
+export interface Settings {
+    enabledUpgradeCommands: string[];
+    versionCheckTimeoutMs?: number;
+}
+export interface LogEntry {
+    timestamp: string;
+    error: string;
+    stackTrace?: string;
+}

package/dist/types/settings.js

@@ -0,0 +1 @@
+export {};

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

@@ -1,2 +1,5 @@
-export declare function createDirectories(): void;
-export declare function copyTemplates(): void;
+export declare class FileService {
+    createStructure(directoryConvention: 'opencode' | 'specifica-br'): Promise<void>;
+    private createDirectories;
+    private copyTemplates;
+}

package/dist/utils/file-service.js

@@ -1,107 +1,74 @@
-"use strict";
-var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
-    if (k2 === undefined) k2 = k;
-    var desc = Object.getOwnPropertyDescriptor(m, k);
-    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
-      desc = { enumerable: true, get: function() { return m[k]; } };
+import fs from 'fs-extra';
+import path from 'path';
+import { fileURLToPath } from 'url';
+const __dirname = path.dirname(fileURLToPath(import.meta.url));
+export class FileService {
+    async createStructure(directoryConvention) {
+        const commandsDestDir = directoryConvention === 'opencode'
+            ? path.join(process.cwd(), '.opencode', 'commands')
+            : path.join(process.cwd(), 'specifica-br', 'commands');
+        console.log(`• Criando diretórios com convenção: ${directoryConvention}`);
+        await this.createDirectories(commandsDestDir, path.join(process.cwd(), 'specs', 'templates'));
+        await this.copyTemplates(commandsDestDir);
     }
-    Object.defineProperty(o, k2, desc);
-}) : (function(o, m, k, k2) {
-    if (k2 === undefined) k2 = k;
-    o[k2] = m[k];
-}));
-var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
-    Object.defineProperty(o, "default", { enumerable: true, value: v });
-}) : function(o, v) {
-    o["default"] = v;
-});
-var __importStar = (this && this.__importStar) || (function () {
-    var ownKeys = function(o) {
-        ownKeys = Object.getOwnPropertyNames || function (o) {
-            var ar = [];
-            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
-            return ar;
-        };
-        return ownKeys(o);
-    };
-    return function (mod) {
-        if (mod && mod.__esModule) return mod;
-        var result = {};
-        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
-        __setModuleDefault(result, mod);
-        return result;
-    };
-})();
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.createDirectories = createDirectories;
-exports.copyTemplates = copyTemplates;
-const fs = __importStar(require("fs-extra"));
-const path = __importStar(require("path"));
-function createDirectories() {
-    const directoriesToCreate = [
-        path.join(process.cwd(), '.opencode', 'commands'),
-        path.join(process.cwd(), 'specs', 'templates')
-    ];
-    directoriesToCreate.forEach((dir) => {
+    async createDirectories(commandsDestDir, templatesDestDir) {
         try {
-            fs.ensureDirSync(dir);
-            console.log(`Diretório criado: ${dir}`);
+            await fs.ensureDir(commandsDestDir);
+            console.log(`✓ Diretório criado: ${commandsDestDir}`);
+            await fs.ensureDir(templatesDestDir);
+            console.log(`✓ Diretório criado: ${templatesDestDir}`);
         }
         catch (error) {
-            if (error instanceof Error) {
-                throw new Error(`Erro ao criar diretório ${dir}: ${error.message}`);
+            if (error instanceof Error && 'code' in error && error.code === 'EACCES') {
+                throw new Error('Erro: Sem permissão para criar diretórios.');
             }
-            throw new Error(`Erro ao criar diretório ${dir}`);
+            throw error;
         }
-    });
-}
-function copyTemplates() {
-    const distRoot = path.resolve(__dirname, '..');
-    const boilerplateDir = path.join(distRoot, 'boilerplate');
-    const templateFiles = [
-        {
-            source: path.join(boilerplateDir, 'opencode-commands', 'gerar-prd.md'),
-            dest: path.join(process.cwd(), '.opencode', 'commands', 'gerar-prd.md')
-        },
-        {
-            source: path.join(boilerplateDir, 'opencode-commands', 'gerar-techspec.md'),
-            dest: path.join(process.cwd(), '.opencode', 'commands', 'gerar-techspec.md')
-        },
-        {
-            source: path.join(boilerplateDir, 'opencode-commands', 'gerar-tasks.md'),
-            dest: path.join(process.cwd(), '.opencode', 'commands', 'gerar-tasks.md')
-        },
-        {
-            source: path.join(boilerplateDir, 'opencode-commands', 'executar-task.md'),
-            dest: path.join(process.cwd(), '.opencode', 'commands', 'executar-task.md')
-        },
-        {
-            source: path.join(boilerplateDir, 'specs-templates', 'prd-template.md'),
-            dest: path.join(process.cwd(), 'specs', 'templates', 'prd-template.md')
-        },
-        {
-            source: path.join(boilerplateDir, 'specs-templates', 'techspec-template.md'),
-            dest: path.join(process.cwd(), 'specs', 'templates', 'techspec-template.md')
-        },
-        {
-            source: path.join(boilerplateDir, 'specs-templates', 'task-template.md'),
-            dest: path.join(process.cwd(), 'specs', 'templates', 'task-template.md')
-        },
-        {
-            source: path.join(boilerplateDir, 'specs-templates', 'tasks-template.md'),
-            dest: path.join(process.cwd(), 'specs', 'templates', 'tasks-template.md')
-        }
-    ];
-    templateFiles.forEach(({ source, dest }) => {
-        try {
-            fs.copySync(source, dest, { overwrite: true });
-            console.log(`Arquivo copiado: ${path.basename(dest)}`);
-        }
-        catch (error) {
-            if (error instanceof Error) {
-                throw new Error(`Erro ao copiar arquivo ${source}: ${error.message}`);
+    }
+    async copyTemplates(commandsDestDir) {
+        const distRoot = path.resolve(__dirname, '..', 'boilerplate');
+        const templateFiles = [
+            {
+                source: path.join(distRoot, 'opencode-commands', 'gerar-prd.md'),
+                dest: path.join(commandsDestDir, 'gerar-prd.md')
+            },
+            {
+                source: path.join(distRoot, 'opencode-commands', 'gerar-techspec.md'),
+                dest: path.join(commandsDestDir, 'gerar-techspec.md')
+            },
+            {
+                source: path.join(distRoot, 'opencode-commands', 'gerar-tasks.md'),
+                dest: path.join(commandsDestDir, 'gerar-tasks.md')
+            },
+            {
+                source: path.join(distRoot, 'opencode-commands', 'executar-task.md'),
+                dest: path.join(commandsDestDir, 'executar-task.md')
+            },
+            {
+                source: path.join(distRoot, 'specs-templates', 'prd-template.md'),
+                dest: path.join(process.cwd(), 'specs', 'templates', 'prd-template.md')
+            },
+            {
+                source: path.join(distRoot, 'specs-templates', 'techspec-template.md'),
+                dest: path.join(process.cwd(), 'specs', 'templates', 'techspec-template.md')
+            },
+            {
+                source: path.join(distRoot, 'specs-templates', 'task-template.md'),
+                dest: path.join(process.cwd(), 'specs', 'templates', 'task-template.md')
+            },
+            {
+                source: path.join(distRoot, 'specs-templates', 'tasks-template.md'),
+                dest: path.join(process.cwd(), 'specs', 'templates', 'tasks-template.md')
+            }
+        ];
+        for (const { source, dest } of templateFiles) {
+            if (await fs.pathExists(source)) {
+                await fs.copy(source, dest, { overwrite: true });
+                console.log(`✓ Arquivo copiado: ${path.basename(dest)}`);
+            }
+            else {
+                throw new Error(`Erro: Diretório de templates não encontrado em ${source}`);
             }
-            throw new Error(`Erro ao copiar arquivo ${source}`);
         }
-    });
+    }
 }

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

@@ -0,0 +1,7 @@
+declare class LogService {
+    private ensureLogsDirectoryExists;
+    private generateLogFileName;
+    logError(error: Error, context?: string): Promise<string>;
+}
+export { LogService };
+export declare const logService: LogService;

package/dist/utils/log-service.js

@@ -0,0 +1,48 @@
+import fs from 'fs-extra';
+import path from 'path';
+const LOGS_DIR = path.join(process.cwd(), '.specifica-br', 'logs');
+class LogService {
+    async ensureLogsDirectoryExists() {
+        try {
+            await fs.ensureDir(LOGS_DIR);
+        }
+        catch (error) {
+            if (error.code !== 'EEXIST') {
+                throw error;
+            }
+        }
+    }
+    generateLogFileName() {
+        const now = new Date();
+        const year = now.getFullYear();
+        const month = String(now.getMonth() + 1).padStart(2, '0');
+        const day = String(now.getDate()).padStart(2, '0');
+        const hours = String(now.getHours()).padStart(2, '0');
+        const minutes = String(now.getMinutes()).padStart(2, '0');
+        const seconds = String(now.getSeconds()).padStart(2, '0');
+        const fileName = `log_${year}_${month}_${day}_${hours}_${minutes}_${seconds}.txt`;
+        return fileName;
+    }
+    async logError(error, context) {
+        await this.ensureLogsDirectoryExists();
+        const logEntry = {
+            timestamp: new Date().toISOString(),
+            error: error.message,
+            stackTrace: error.stack
+        };
+        const fileName = this.generateLogFileName();
+        const filePath = path.join(LOGS_DIR, fileName);
+        let logContent = `[${logEntry.timestamp}] ERROR\n`;
+        logContent += `Message: ${logEntry.error}\n`;
+        if (context) {
+            logContent += `Context: ${context}\n`;
+        }
+        if (logEntry.stackTrace) {
+            logContent += `Stack Trace:\n${logEntry.stackTrace}\n`;
+        }
+        await fs.writeFile(filePath, logContent);
+        return path.resolve(filePath);
+    }
+}
+export { LogService };
+export const logService = new LogService();

package/dist/utils/message-formatter.d.ts

@@ -1,4 +1,4 @@
-export declare function showSuccessMessage(): void;
+export declare function showSuccessMessage(directoryConvention: 'opencode' | 'specifica-br'): void;
 export declare function showMissionMessage(): void;
 export declare function showErrorMessage(message: string): void;
 export declare function showInfoMessage(message: string): void;

package/dist/utils/message-formatter.js

@@ -1,68 +1,65 @@
-"use strict";
-var __importDefault = (this && this.__importDefault) || function (mod) {
-    return (mod && mod.__esModule) ? mod : { "default": mod };
-};
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.showSuccessMessage = showSuccessMessage;
-exports.showMissionMessage = showMissionMessage;
-exports.showErrorMessage = showErrorMessage;
-exports.showInfoMessage = showInfoMessage;
-const chalk_1 = __importDefault(require("chalk"));
-function showSuccessMessage() {
-    console.log('');
-    console.log(chalk_1.default.green.bold('✓ Estrutura SDD criada com sucesso!'));
-    console.log('');
-    console.log(chalk_1.default.gray('Diretórios criados:'));
-    console.log(chalk_1.default.gray('  - .opencode/commands'));
-    console.log(chalk_1.default.gray('  - specs/templates'));
-    console.log('');
-    console.log(chalk_1.default.gray('Arquivos de comandos copiados:'));
-    console.log(chalk_1.default.gray('  - gerar-prd.md'));
-    console.log(chalk_1.default.gray('  - gerar-techspec.md'));
-    console.log(chalk_1.default.gray('  - gerar-tasks.md'));
-    console.log(chalk_1.default.gray('  - executar-task.md'));
-    console.log('');
-    console.log(chalk_1.default.gray('Arquivos de templates copiados:'));
-    console.log(chalk_1.default.gray('  - prd-template.md'));
-    console.log(chalk_1.default.gray('  - techspec-template.md'));
-    console.log(chalk_1.default.gray('  - task-template.md'));
-    console.log(chalk_1.default.gray('  - tasks-template.md'));
+import chalk from 'chalk';
+export function showSuccessMessage(directoryConvention) {
+    const commandDir = directoryConvention === 'opencode'
+        ? '.opencode/commands/'
+        : 'specifica-br/commands/';
+    console.log('');
+    console.log(chalk.green.bold('✓ Estrutura SDD criada com sucesso!'));
+    console.log('');
+    console.log(chalk.gray('Diretórios criados:'));
+    console.log(chalk.gray(`  • ${commandDir}`));
+    console.log(chalk.gray('  • specs/templates/'));
+    console.log('');
+    console.log(chalk.gray('Arquivos de comandos copiados:'));
+    console.log(chalk.gray('  • gerar-prd.md'));
+    console.log(chalk.gray('  • gerar-techspec.md'));
+    console.log(chalk.gray('  • gerar-tasks.md'));
+    console.log(chalk.gray('  • executar-task.md'));
+    console.log('');
+    console.log(chalk.gray('Arquivos de templates copiados:'));
+    console.log(chalk.gray('  • prd-template.md'));
+    console.log(chalk.gray('  • techspec-template.md'));
+    console.log(chalk.gray('  • task-template.md'));
+    console.log(chalk.gray('  • tasks-template.md'));
+    console.log('');
+    console.log(chalk.gray('Para começar, navegue até o diretório de comandos e execute:'));
+    console.log(chalk.gray(`  cd ${commandDir.split('/')[0]}`));
     console.log('');
 }
-function showMissionMessage() {
+export function showMissionMessage() {
     console.log('');
-    console.log(chalk_1.default.cyan.bold('Bem-vindo ao Specifica-BR!'));
+    console.log(chalk.cyan.bold('Bem-vindo ao Specifica-BR!'));
     console.log('');
-    console.log(chalk_1.default.yellow('O que é Spec Driven Development (SDD)?'));
+    console.log(chalk.yellow('O que é Spec Driven Development (SDD)?'));
     console.log('');
-    console.log(chalk_1.default.white('SDD é uma metodologia de desenvolvimento que prioriza'));
-    console.log(chalk_1.default.white('a documentação e especificação antes da escrita de código.'));
+    console.log(chalk.white('SDD é uma metodologia de desenvolvimento que prioriza'));
+    console.log(chalk.white('a documentação e especificação antes da escrita de código.'));
     console.log('');
-    console.log(chalk_1.default.yellow('Benefícios do SDD:'));
+    console.log(chalk.yellow('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_1.default.white('  • Maior qualidade e manutenibilidade'));
+    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(chalk.white('  • Maior qualidade e manutenibilidade'));
     console.log('');
-    console.log(chalk_1.default.yellow('Próximos passos:'));
+    console.log(chalk.yellow('Próximos passos:'));
     console.log('');
-    console.log(chalk_1.default.white('  1. Execute: specifica help --completo'));
-    console.log(chalk_1.default.white('  2. Crie seu PRD usando o template'));
-    console.log(chalk_1.default.white('  3. Gere sua Tech Spec baseada no PRD'));
-    console.log(chalk_1.default.white('  4. Decomponha em tarefas executáveis'));
+    console.log(chalk.white('  1. Execute: specifica help --completo'));
+    console.log(chalk.white('  2. Crie seu PRD usando o template'));
+    console.log(chalk.white('  3. Gere sua Tech Spec baseada no PRD'));
+    console.log(chalk.white('  4. Decomponha em tarefas executáveis'));
     console.log('');
-    console.log(chalk_1.default.cyan.bold('Comece agora com: specifica help'));
+    console.log(chalk.cyan.bold('Comece agora com o comando: specifica-br help'));
     console.log('');
 }
-function showErrorMessage(message) {
+export function showErrorMessage(message) {
     console.error('');
-    console.error(chalk_1.default.red.bold('✗ Erro:'));
-    console.error(chalk_1.default.red(message));
+    console.error(chalk.red.bold('Erro:'));
+    console.error(chalk.red(message));
     console.error('');
 }
-function showInfoMessage(message) {
+export function showInfoMessage(message) {
     console.log('');
-    console.log(chalk_1.default.blue('ℹ ' + message));
+    console.log(chalk.blue('ℹ ' + message));
     console.log('');
 }

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

@@ -0,0 +1,6 @@
+import { Settings } from '../types/settings.js';
+declare class SettingsService {
+    getSettings(): Promise<Settings>;
+}
+export { SettingsService };
+export declare const settingsService: SettingsService;

package/dist/utils/settings-service.js

@@ -0,0 +1,26 @@
+import fs from 'fs-extra';
+import path from 'path';
+import { fileURLToPath } from 'url';
+const __dirname = path.dirname(fileURLToPath(import.meta.url));
+const SETTINGS_PATH = path.join(__dirname, '..', 'settings.json');
+class SettingsService {
+    async getSettings() {
+        try {
+            const settingsContent = await fs.readFile(SETTINGS_PATH, 'utf-8');
+            const settings = JSON.parse(settingsContent);
+            return settings;
+        }
+        catch (error) {
+            const errorCode = error.code;
+            if (errorCode === 'ENOENT') {
+                const defaultSettings = {
+                    enabledUpgradeCommands: ['init', 'help', 'upgrade']
+                };
+                return defaultSettings;
+            }
+            throw error;
+        }
+    }
+}
+export { SettingsService };
+export const settingsService = new SettingsService();

package/dist/utils/update-notifier-middleware.d.ts

@@ -0,0 +1,59 @@
+declare class UpdateNotifierMiddleware {
+    private shouldNotify;
+    private getLatestVersion;
+    /**
+     * Obtém a versão mais recente com timeout configurável
+     * @param packageName Nome do pacote
+     * @param timeoutMs Timeout em milissegundos
+     * @returns Promise com a versão ou null em caso de timeout/erro
+     */
+    private getLatestVersionWithTimeout;
+    /**
+     * Verifica se há uma nova versão disponível
+     * @param currentVersion Versão atual
+     * @param latestVersion Versão mais recente
+     * @returns boolean true se houver nova versão
+     */
+    private isNewVersionAvailable;
+    /**
+     * Obtém a versão atual do package.json
+     * @returns string com a versão atual
+     */
+    private getCurrentVersion;
+    private isValidVersion;
+    private getUpdateType;
+    /**
+     * Exibe prompt interativo perguntando se o usuário deseja atualizar
+     * @param latestVersion Versão mais recente disponível
+     * @returns Promise<boolean> true se o usuário aceitar atualizar
+     */
+    private promptUserForUpdate;
+    /**
+     * Exibe prompt de retry após falha na atualização
+     * @returns Promise<boolean> true se o usuário quiser tentar novamente
+     */
+    private promptForRetry;
+    /**
+     * Executa a atualização do pacote via npm install -g
+     * @param retryCount Número de tentativas já realizadas
+     * @returns Promise<void>
+     */
+    private executeUpdate;
+    /**
+     * Exibe notificação e prompt interativo para atualização
+     * @param latestVersion Versão mais recente disponível
+     * @param originalAction Função original a ser executada se recusar atualização
+     * @returns Promise<void>
+     */
+    private displayNotificationWithPrompt;
+    /**
+     * Envelopa uma função com verificação de atualização
+     * @param commandName Nome do comando sendo executado
+     * @param originalAction Função original a ser executada
+     * @returns Promise com o resultado da função original
+     */
+    wrap(commandName: string, originalAction: () => Promise<void>): Promise<void>;
+    private displayNotification;
+}
+export declare const updateNotifierMiddleware: UpdateNotifierMiddleware;
+export {};