@brunoluizdesiqueira/bbuilder-cli 1.0.1 → 1.0.3

package/README.md

@@ -23,6 +23,122 @@ npm install -g @brunoluizdesiqueira/bbuilder-cli
 npm publish --access public
 ```
 
+## Publicação
+
+### Publicação manual inicial
+
+Use esse fluxo para a primeira publicação ou para publicar manualmente uma versão:
+
+1. Faça login no npm:
+
+```bash
+npm login
+```
+
+2. Valide o pacote localmente:
+
+```bash
+npm run build
+npm pack --dry-run
+```
+
+3. Publique:
+
+```bash
+npm publish --access public
+```
+
+Se a versão atual do `package.json` já tiver sido publicada, gere uma nova versão antes:
+
+```bash
+npm version patch --no-git-tag-version
+npm publish --access public
+```
+
+### Configurar publicação automática
+
+Depois da primeira publicação manual, configure o npm para confiar no workflow do GitHub Actions.
+
+No npm:
+
+1. abra a página do pacote `@brunoluizdesiqueira/bbuilder-cli`
+2. vá em `Settings`
+3. abra `Trusted publishing`
+4. adicione um publisher do tipo `GitHub Actions`
+5. configure:
+   - repositório: `brunoluizdesiqueira/b-cli`
+   - workflow: `release.yml`
+
+Na opção **Publishing access**, use:
+
+- `Require two-factor authentication or a granular access token with bypass 2fa enabled`
+
+Evite para esse fluxo:
+
+- `Require two-factor authentication and disallow tokens`
+
+### Publicação automática com Changesets
+
+Depois do Trusted Publisher configurado, o fluxo recomendado fica assim:
+
+1. criar uma changeset para cada mudança publicada:
+
+```bash
+npm run changeset
+```
+
+2. fazer commit da changeset junto com o código
+3. abrir PR e fazer merge na `main`
+4. o workflow `Release` abre ou atualiza uma PR de release
+5. ao mergear a PR de release, o npm é publicado automaticamente
+
+Comandos locais úteis:
+
+```bash
+npm run changeset
+npm run version-packages
+npm run release
+```
+
+### Troubleshooting do publish automático
+
+Se a PR de release for mergeada, a versão subir para o `package.json`, mas o publish no npm falhar com erro parecido com:
+
+```text
+E404 Not Found - PUT https://registry.npmjs.org/@brunoluizdesiqueira%2fbbuilder-cli - Not found
+```
+
+verifique estes pontos:
+
+1. o Trusted Publisher do pacote está configurado para:
+   - owner/user: `brunoluizdesiqueira`
+   - repository: `b-cli`
+   - workflow: `release.yml`
+2. o repositório GitHub é público
+3. o workflow `Release` tem `permissions.id-token: write`
+4. o workflow roda com Node e npm atuais
+
+O ajuste que resolveu esse cenário neste projeto foi:
+
+- usar `actions/setup-node@v5`
+- executar o workflow com Node `24`
+- atualizar o npm antes do publish
+- definir no `package.json`:
+
+```json
+"publishConfig": {
+  "access": "public",
+  "provenance": true
+}
+```
+
+## CI/CD
+
+O repositório agora está preparado com GitHub Actions:
+
+- `CI`: roda em `push` e `pull_request`, executando `npm ci`, `tsc`, `build` e `npm pack --dry-run`
+- `Release`: usa `changesets` para abrir uma PR de release com bump de versão e changelog; quando essa PR entra na `main`, o pacote é publicado no npm
+
 Ou use direto sem instalar globalmente:
 ```bash
 npx ts-node src/index.ts build
@@ -57,12 +173,15 @@ bbuilder release --project Bimer --version 11.3.1
 ```bash
 bbuilder project list   # lista projetos configurados
 bbuilder project add    # adiciona novo projeto (interativo)
+bbuilder project remove # remove projeto (interativo ou por --name)
 ```
 
 ### Configuração do ambiente
 ```bash
 bbuilder config init    # assistente para criar bbuilder.config.json
 bbuilder config show    # exibe configuração atual
+bbuilder config validate # valida a estrutura do arquivo de configuração
+bbuilder doctor         # diagnostica ambiente, config e paths
 ```
 
 ---
@@ -110,6 +229,46 @@ Crie com `bbuilder config init`, ou manualmente:
 
 Se o arquivo não existir, os valores padrão acima são usados automaticamente. Ao rodar `bbuilder config init`, a CLI gera um `dependencyPaths` inicial com base nos diretórios informados.
 
+### Como usar configs locais
+
+O pacote é instalado normalmente, e a configuração é informada na execução, não na instalação.
+
+Instalação global:
+
+```bash
+npm install -g @brunoluizdesiqueira/bbuilder-cli
+```
+
+Usando um arquivo de config local explícito:
+
+```bash
+bbuilder --config C:\configs\bbuilder.config.json build
+```
+
+Usando variável de ambiente no Windows CMD:
+
+```bat
+set BBUILDER_CONFIG=C:\configs\bbuilder.config.json
+bbuilder build
+```
+
+Usando variável de ambiente no PowerShell:
+
+```powershell
+$env:BBUILDER_CONFIG="C:\configs\bbuilder.config.json"
+bbuilder build
+```
+
+Usando config local no diretório atual:
+
+Se existir um `bbuilder.config.json` na pasta onde o comando é executado, a CLI usa esse arquivo automaticamente.
+
+Para verificar qual arquivo está sendo usado:
+
+```bash
+bbuilder config show
+```
+
 Exemplos:
 
 ```bash
@@ -188,15 +347,41 @@ E nos keybindings, nada muda — os atalhos continuam os mesmos.
 
 ```
 bbuilder-cli/
+├── .changeset/
+│   ├── config.json
+│   └── *.md
+├── .github/
+│   └── workflows/
+│       ├── ci.yml
+│       └── release.yml
 ├── src/
 │   ├── build/
+│   │   ├── compiler.ts
+│   │   ├── execute.ts
+│   │   ├── project.ts
+│   │   └── resources.ts
 │   ├── cli/
+│   │   └── program.ts
 │   ├── config/
+│   │   ├── config.ts
+│   │   └── validate.ts
+│   ├── diagnostics/
+│   │   └── doctor.ts
 │   ├── ui/
+│   │   ├── output.ts
+│   │   └── prompts.ts
 │   ├── index.ts
 │   └── types.ts
+├── files/
+│   ├── build_local.bat
+│   ├── tasks.json
+│   └── ...
+├── bbuilder.config.json
 ├── package.json
+├── package-lock.json
 ├── tsconfig.json
+├── .gitignore
+├── LICENSE
 └── README.md
 ```
 

package/dist/build/compiler.js

@@ -70,7 +70,10 @@ function buildCompilerFlags(buildType) {
     }
 }
 function buildDependencies(opts) {
-    return opts.dependencyPaths.map(p => `"${p}"`).join(';');
+    // execa passes each compiler switch as a single argv entry, so we should
+    // not embed quotes inside the semicolon-separated list. Doing that can make
+    // dcc64 fail to resolve paths such as the Delphi runtime library.
+    return opts.dependencyPaths.join(';');
 }
 async function runCgrc(opts, projectName) {
     const tempDir = path.join(os.tmpdir(), `BimerBuild_${projectName}`);

package/dist/cli/program.js

@@ -8,24 +8,97 @@ const commander_1 = require("commander");
 const chalk_1 = __importDefault(require("chalk"));
 const execute_1 = require("../build/execute");
 const config_1 = require("../config/config");
+const validate_1 = require("../config/validate");
+const doctor_1 = require("../diagnostics/doctor");
 const output_1 = require("../ui/output");
 const prompts_1 = require("../ui/prompts");
+const packageJson = require('../../package.json');
+const HELP_EXAMPLES = {
+    root: [
+        'Exemplos:',
+        '  bbuilder',
+        '  bbuilder build --type DEBUG --project faturamento\\BimerFaturamento',
+        '  bbuilder fast --project Bimer',
+        '  bbuilder --config C:\\configs\\bbuilder.config.json doctor',
+    ].join('\n'),
+    build: [
+        'Exemplos:',
+        '  bbuilder build',
+        '  bbuilder build --type RELEASE --project Bimer --version 11.3.1',
+        '  bbuilder build --type FAST --project faturamento\\BimerFaturamento',
+    ].join('\n'),
+    fast: [
+        'Exemplos:',
+        '  bbuilder fast',
+        '  bbuilder fast --project Bimer',
+        '  bbuilder fast --project faturamento\\BimerFaturamento --version 11.3.1',
+    ].join('\n'),
+    debug: [
+        'Exemplos:',
+        '  bbuilder debug',
+        '  bbuilder debug --project Bimer',
+        '  bbuilder debug --project faturamento\\BimerFaturamento --version 11.3.1',
+    ].join('\n'),
+    release: [
+        'Exemplos:',
+        '  bbuilder release',
+        '  bbuilder release --project Bimer',
+        '  bbuilder release --project faturamento\\BimerFaturamento --version 11.3.1',
+    ].join('\n'),
+    config: [
+        'Exemplos:',
+        '  bbuilder config init',
+        '  bbuilder config show',
+        '  bbuilder config validate',
+        '  bbuilder --config C:\\configs\\bbuilder.config.json config show',
+    ].join('\n'),
+    configValidate: [
+        'Exemplos:',
+        '  bbuilder config validate',
+        '  bbuilder --config C:\\configs\\bbuilder.config.json config validate',
+    ].join('\n'),
+    project: [
+        'Exemplos:',
+        '  bbuilder project list',
+        '  bbuilder project add',
+        '  bbuilder project remove',
+        '  bbuilder project remove --name Bimer',
+    ].join('\n'),
+    projectRemove: [
+        'Exemplos:',
+        '  bbuilder project remove',
+        '  bbuilder project remove --name Bimer',
+    ].join('\n'),
+    doctor: [
+        'Exemplos:',
+        '  bbuilder doctor',
+        '  bbuilder --config C:\\configs\\bbuilder.config.json doctor',
+    ].join('\n'),
+};
+function attachHelpExamples(command, examples) {
+    command.on('--help', () => {
+        console.log('');
+        console.log(examples);
+        console.log('');
+    });
+    return command;
+}
 async function runCli(argv) {
     const resolvedConfigPath = (0, config_1.resolveConfigPath)(argv);
     const writableConfigPath = (0, config_1.getWritableConfigPath)(resolvedConfigPath);
     const config = (0, config_1.loadConfig)(resolvedConfigPath);
     const program = new commander_1.Command();
-    program
+    attachHelpExamples(program
         .name('bbuilder')
         .description('CLI de build local para projetos Delphi do Bimer')
-        .version('1.0.0')
-        .option('-c, --config <path>', `Caminho do arquivo de configuração (ou ${config_1.CONFIG_ENV_VAR})`);
-    program
+        .version(packageJson.version)
+        .option('-c, --config <path>', `Caminho do arquivo de configuração (ou ${config_1.CONFIG_ENV_VAR})`), HELP_EXAMPLES.root);
+    const buildCmd = attachHelpExamples(program
         .command('build')
         .description('Compila um projeto Delphi (interativo se flags omitidas)')
         .option('-t, --type <FAST|DEBUG|RELEASE>', 'Modo de build')
         .option('-p, --project <path>', 'Caminho do projeto (ex: faturamento\\BimerFaturamento)')
-        .option('-v, --version <version>', 'Versão a injetar (ex: 11.2.4)')
+        .option('-v, --version <version>', 'Versão a injetar (ex: 11.2.4)'), HELP_EXAMPLES.build)
         .action(async (opts) => {
         const buildType = opts.type?.toUpperCase();
         if (buildType && !['FAST', 'DEBUG', 'RELEASE'].includes(buildType)) {
@@ -35,7 +108,7 @@ async function runCli(argv) {
         await (0, execute_1.executeBuild)(resolved);
     });
     for (const type of ['fast', 'debug', 'release']) {
-        program
+        const shortcutCmd = program
             .command(type)
             .description(`Compila no modo ${type.toUpperCase()} (interativo para projeto/versão)`)
             .option('-p, --project <path>', 'Caminho do projeto')
@@ -44,10 +117,11 @@ async function runCli(argv) {
             const resolved = await (0, prompts_1.promptBuild)(config, type.toUpperCase(), opts.project, opts.version);
             await (0, execute_1.executeBuild)(resolved);
         });
+        attachHelpExamples(shortcutCmd, HELP_EXAMPLES[type]);
     }
-    const configCmd = program
+    const configCmd = attachHelpExamples(program
         .command('config')
-        .description('Gerencia a configuração do ambiente');
+        .description('Gerencia a configuração do ambiente'), HELP_EXAMPLES.config);
     configCmd
         .command('init')
         .description('Configura o ambiente de forma interativa (cria bbuilder.config.json)')
@@ -67,9 +141,14 @@ async function runCli(argv) {
             .join('\n'));
         console.log('');
     });
-    const projectCmd = program
+    const configValidateCmd = configCmd
+        .command('validate')
+        .description('Valida a estrutura do arquivo de configuração')
+        .action(() => (0, validate_1.runConfigValidate)(resolvedConfigPath));
+    attachHelpExamples(configValidateCmd, HELP_EXAMPLES.configValidate);
+    const projectCmd = attachHelpExamples(program
         .command('project')
-        .description('Gerencia a lista de projetos');
+        .description('Gerencia a lista de projetos'), HELP_EXAMPLES.project);
     projectCmd
         .command('add')
         .description('Adiciona um novo projeto à lista')
@@ -86,6 +165,16 @@ async function runCli(argv) {
         });
         console.log('');
     });
+    const projectRemoveCmd = projectCmd
+        .command('remove')
+        .description('Remove um projeto da lista')
+        .option('-n, --name <projectName>', 'Nome do projeto cadastrado')
+        .action((opts) => (0, prompts_1.runProjectRemove)(config, writableConfigPath, opts.name));
+    attachHelpExamples(projectRemoveCmd, HELP_EXAMPLES.projectRemove);
+    attachHelpExamples(program
+        .command('doctor')
+        .description('Diagnostica configuração, paths e binários do ambiente')
+        .action(() => (0, doctor_1.runDoctor)(config, resolvedConfigPath)), HELP_EXAMPLES.doctor);
     if (argv.length <= 2) {
         (0, output_1.banner)();
         const resolved = await (0, prompts_1.promptBuild)(config);

package/dist/config/validate.js

@@ -0,0 +1,140 @@
+"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]; } };
+    }
+    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;
+    };
+})();
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.validateConfigObject = validateConfigObject;
+exports.runConfigValidate = runConfigValidate;
+const chalk_1 = __importDefault(require("chalk"));
+const fs = __importStar(require("fs"));
+function isNonEmptyString(value) {
+    return typeof value === 'string' && value.trim().length > 0;
+}
+function validateProjects(projects) {
+    if (!projects || typeof projects !== 'object' || Array.isArray(projects)) {
+        return [{ field: 'projects', message: 'deve ser um objeto no formato nome => caminho' }];
+    }
+    const entries = Object.entries(projects);
+    if (entries.length === 0) {
+        return [{ field: 'projects', message: 'deve conter ao menos um projeto configurado' }];
+    }
+    const issues = [];
+    for (const [name, projectPath] of entries) {
+        if (!isNonEmptyString(name)) {
+            issues.push({ field: 'projects', message: 'contém uma chave de projeto inválida' });
+        }
+        if (!isNonEmptyString(projectPath)) {
+            issues.push({ field: `projects.${name}`, message: 'deve apontar para um caminho não vazio' });
+        }
+    }
+    return issues;
+}
+function validateConfigObject(raw) {
+    if (!raw || typeof raw !== 'object' || Array.isArray(raw)) {
+        return [{ field: 'config', message: 'o arquivo deve conter um objeto JSON válido' }];
+    }
+    const config = raw;
+    const issues = [];
+    const requiredStringFields = [
+        'repoBase',
+        'delphiDir',
+        'envVersion',
+        'libRoot',
+        'libErp',
+        'libAlterdata',
+    ];
+    for (const field of requiredStringFields) {
+        if (!isNonEmptyString(config[field])) {
+            issues.push({ field, message: 'deve ser uma string não vazia' });
+        }
+    }
+    if (!Array.isArray(config.dependencyPaths) || config.dependencyPaths.length === 0) {
+        issues.push({ field: 'dependencyPaths', message: 'deve ser um array com ao menos um path' });
+    }
+    else {
+        config.dependencyPaths.forEach((depPath, index) => {
+            if (!isNonEmptyString(depPath)) {
+                issues.push({ field: `dependencyPaths[${index}]`, message: 'deve ser uma string não vazia' });
+            }
+        });
+    }
+    issues.push(...validateProjects(config.projects));
+    return issues;
+}
+function runConfigValidate(configPath) {
+    console.log('');
+    console.log(chalk_1.default.cyan('  Validação da Configuração'));
+    console.log(chalk_1.default.blue('  ─────────────────────────'));
+    console.log(chalk_1.default.gray(`  Arquivo: ${configPath}`));
+    console.log('');
+    if (!fs.existsSync(configPath)) {
+        console.log(chalk_1.default.red('  FAIL   Arquivo de configuração não encontrado.'));
+        console.log('');
+        process.exitCode = 1;
+        return;
+    }
+    let rawText;
+    try {
+        rawText = fs.readFileSync(configPath, 'utf-8');
+    }
+    catch (error) {
+        console.log(chalk_1.default.red(`  FAIL   Não foi possível ler o arquivo: ${error instanceof Error ? error.message : String(error)}`));
+        console.log('');
+        process.exitCode = 1;
+        return;
+    }
+    let parsed;
+    try {
+        parsed = JSON.parse(rawText);
+    }
+    catch (error) {
+        console.log(chalk_1.default.red(`  FAIL   JSON inválido: ${error instanceof Error ? error.message : String(error)}`));
+        console.log('');
+        process.exitCode = 1;
+        return;
+    }
+    const issues = validateConfigObject(parsed);
+    if (issues.length === 0) {
+        console.log(chalk_1.default.green('  OK     Estrutura da configuração está válida.'));
+        console.log('');
+        return;
+    }
+    issues.forEach(issue => {
+        console.log(chalk_1.default.red(`  FAIL   ${issue.field}: ${issue.message}`));
+    });
+    console.log('');
+    process.exitCode = 1;
+}

package/dist/diagnostics/doctor.js

@@ -0,0 +1,129 @@
+"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]; } };
+    }
+    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;
+    };
+})();
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.runDoctor = runDoctor;
+const chalk_1 = __importDefault(require("chalk"));
+const fs = __importStar(require("fs"));
+const path = __importStar(require("path"));
+function checkPath(label, targetPath) {
+    return {
+        label,
+        ok: fs.existsSync(targetPath),
+        detail: targetPath,
+    };
+}
+function checkFile(label, targetPath) {
+    return {
+        label,
+        ok: fs.existsSync(targetPath) && fs.statSync(targetPath).isFile(),
+        detail: targetPath,
+    };
+}
+function printCheck(result) {
+    const status = result.ok ? chalk_1.default.green('OK') : chalk_1.default.red('FAIL');
+    console.log(`  ${status.padEnd(6)} ${chalk_1.default.white(result.label)} ${chalk_1.default.gray(`→ ${result.detail}`)}`);
+}
+function runDoctor(config, resolvedConfigPath) {
+    const checks = [];
+    const cgrcPath = path.win32.join(config.delphiDir, 'bin', 'cgrc.exe');
+    const dcc64Path = path.win32.join(config.delphiDir, 'bin', 'dcc64.exe');
+    const delphiRuntimePath = path.win32.join(config.delphiDir, 'lib', 'Win64', 'release');
+    checks.push(checkFile('Arquivo de configuração em uso', resolvedConfigPath));
+    checks.push(checkPath('repoBase', config.repoBase));
+    checks.push(checkPath('delphiDir', config.delphiDir));
+    checks.push(checkPath('Delphi runtime Win64', delphiRuntimePath));
+    checks.push(checkPath('libRoot', config.libRoot));
+    checks.push(checkPath('libErp', config.libErp));
+    checks.push(checkPath('libAlterdata', config.libAlterdata));
+    checks.push(checkFile('cgrc.exe', cgrcPath));
+    checks.push(checkFile('dcc64.exe', dcc64Path));
+    const projectEntries = Object.entries(config.projects);
+    checks.push({
+        label: 'Projetos configurados',
+        ok: projectEntries.length > 0,
+        detail: `${projectEntries.length} projeto(s)`,
+    });
+    checks.push({
+        label: 'dependencyPaths configurados',
+        ok: Array.isArray(config.dependencyPaths) && config.dependencyPaths.length > 0,
+        detail: `${config.dependencyPaths.length} path(s)`,
+    });
+    checks.push({
+        label: 'Delphi runtime presente em dependencyPaths',
+        ok: config.dependencyPaths.includes(delphiRuntimePath),
+        detail: delphiRuntimePath,
+    });
+    console.log('');
+    console.log(chalk_1.default.cyan('  Diagnóstico do Ambiente'));
+    console.log(chalk_1.default.blue('  ───────────────────────'));
+    console.log(chalk_1.default.gray(`  Config: ${resolvedConfigPath}`));
+    console.log('');
+    checks.forEach(printCheck);
+    if (projectEntries.length > 0) {
+        console.log('');
+        console.log(chalk_1.default.cyan('  Projetos'));
+        console.log(chalk_1.default.blue('  ────────'));
+        projectEntries.forEach(([name, projectPath]) => {
+            const fullPath = path.win32.join(config.repoBase, projectPath);
+            const dprojPath = `${fullPath}.dproj`;
+            const exists = fs.existsSync(dprojPath);
+            const status = exists ? chalk_1.default.green('OK') : chalk_1.default.red('FAIL');
+            console.log(`  ${status.padEnd(6)} ${chalk_1.default.white(name)} ${chalk_1.default.gray(`→ ${dprojPath}`)}`);
+        });
+    }
+    if (config.dependencyPaths.length > 0) {
+        console.log('');
+        console.log(chalk_1.default.cyan('  Dependências'));
+        console.log(chalk_1.default.blue('  ────────────'));
+        config.dependencyPaths.forEach(depPath => {
+            const exists = fs.existsSync(depPath);
+            const status = exists ? chalk_1.default.green('OK') : chalk_1.default.yellow('WARN');
+            console.log(`  ${status.padEnd(6)} ${chalk_1.default.gray(depPath)}`);
+        });
+    }
+    const failed = checks.filter(check => !check.ok).length;
+    console.log('');
+    if (failed === 0) {
+        console.log(chalk_1.default.green('  Ambiente básico validado com sucesso.'));
+    }
+    else {
+        console.log(chalk_1.default.yellow(`  Diagnóstico concluído com ${failed} problema(s) principal(is).`));
+        process.exitCode = 1;
+    }
+    console.log('');
+}

package/dist/ui/prompts.js

@@ -6,6 +6,7 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.promptBuild = promptBuild;
 exports.runConfigInit = runConfigInit;
 exports.runProjectAdd = runProjectAdd;
+exports.runProjectRemove = runProjectRemove;
 const chalk_1 = __importDefault(require("chalk"));
 const inquirer_1 = __importDefault(require("inquirer"));
 const config_1 = require("../config/config");
@@ -122,3 +123,37 @@ async function runProjectAdd(config, configPath) {
     (0, config_1.saveConfig)(nextConfig, configPath);
     console.log(chalk_1.default.green(`\n  ✔ Projeto "${projectName}" adicionado!\n`));
 }
+async function runProjectRemove(config, configPath, cliProjectName) {
+    const projectEntries = Object.entries(config.projects);
+    if (projectEntries.length === 0) {
+        console.log(chalk_1.default.yellow('\n  Não há projetos cadastrados para remover.\n'));
+        return;
+    }
+    let projectName = cliProjectName;
+    if (!projectName) {
+        const answers = await inquirer_1.default.prompt([
+            {
+                type: 'list',
+                name: 'projectName',
+                message: 'Qual projeto deseja remover?',
+                choices: projectEntries.map(([name, projectPath]) => ({
+                    name: `${name} (${projectPath})`,
+                    value: name,
+                })),
+            },
+        ]);
+        projectName = answers.projectName;
+    }
+    if (!projectName || !config.projects[projectName]) {
+        console.log(chalk_1.default.yellow(`\n  Projeto "${projectName || ''}" não encontrado.\n`));
+        return;
+    }
+    const nextProjects = { ...config.projects };
+    delete nextProjects[projectName];
+    const nextConfig = {
+        ...config,
+        projects: nextProjects,
+    };
+    (0, config_1.saveConfig)(nextConfig, configPath);
+    console.log(chalk_1.default.green(`\n  ✔ Projeto "${projectName}" removido!\n`));
+}

package/package.json

@@ -1,19 +1,42 @@
 {
   "name": "@brunoluizdesiqueira/bbuilder-cli",
-  "version": "1.0.1",
+  "version": "1.0.3",
   "description": "CLI de build local para projetos Delphi do Bimer",
+  "license": "ISC",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/brunoluizdesiqueira/b-cli.git"
+  },
+  "homepage": "https://github.com/brunoluizdesiqueira/b-cli#readme",
+  "bugs": {
+    "url": "https://github.com/brunoluizdesiqueira/b-cli/issues"
+  },
+  "keywords": [
+    "cli",
+    "delphi",
+    "builder",
+    "bimer",
+    "typescript"
+  ],
   "files": [
     "dist",
     "README.md",
     "LICENSE"
   ],
+  "publishConfig": {
+    "access": "public",
+    "provenance": true
+  },
   "bin": {
-    "bbuilder": "dist/index.js"
+    "bbuilder": "./dist/index.js"
   },
   "scripts": {
     "build": "tsc",
     "dev": "ts-node src/index.ts",
-    "prepack": "npm run build"
+    "prepack": "npm run build",
+    "changeset": "changeset",
+    "version-packages": "changeset version",
+    "release": "changeset publish"
   },
   "engines": {
     "node": ">=18"
@@ -25,6 +48,7 @@
     "inquirer": "^8.2.6"
   },
   "devDependencies": {
+    "@changesets/cli": "^2.30.0",
     "@types/inquirer": "^8.2.10",
     "@types/node": "^20.0.0",
     "ts-node": "^10.9.2",