@brunoluizdesiqueira/bbuilder-cli 1.0.17 → 1.0.18

package/README.md

@@ -1,206 +1,41 @@
 # bbuilder-cli
 
-CLI em Node.js/TypeScript que substitui o `build_local.bat` com interface interativa e suporte a flags diretas.
+CLI para build local de projetos Delphi do Bimer.
 
----
+Substitui o `build_local.bat` com:
+- seleção interativa de projeto, modo e versão
+- suporte a `FAST`, `DEBUG` e `RELEASE`
+- configuração por arquivo `bbuilder.config.json`
+- diagnóstico de ambiente com `doctor`
 
-## Instalação
-
-```bash
-# Desenvolvimento local
-npm install
-npm run build
-npm link        # disponibiliza o comando 'bbuilder' globalmente
-```
-
-```bash
-# Instalação via npm
-npm install -g @brunoluizdesiqueira/bbuilder-cli
-```
-
-```bash
-# Publicação
-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
-}
-```
+## Requisitos
 
-## CI/CD
+- Node.js 18+
+- Windows
+- Delphi instalado
+- bibliotecas do projeto disponíveis na máquina
 
-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
+## Instalação
 
-Ou use direto sem instalar globalmente:
 ```bash
-npx ts-node src/index.ts build
+npm install -g @brunoluizdesiqueira/bbuilder-cli
 ```
 
----
-
-## Uso
-
-### Modo interativo (sem argumentos)
-```bash
-bbuilder
-```
-Exibe menus para escolher: modo de build → projeto → versão.
+Depois confirme:
 
-### Comando `build` com flags opcionais
 ```bash
-bbuilder build                                       # interativo completo
-bbuilder build --type DEBUG                          # escolhe projeto e versão interativamente
-bbuilder build --type FAST --project faturamento\BimerFaturamento
-bbuilder build --type RELEASE --project Bimer --version 11.3.1
+bbuilder --version
 ```
 
-Durante o build, o CLI exibe feedback visual por etapas com spinner, barra indeterminada e tempo decorrido. Essa barra representa atividade do pipeline, não percentual real do `dcc64`.
-
-### Atalhos diretos por modo
-```bash
-bbuilder fast                                        # interativo para projeto/versão
-bbuilder debug --project Bimer
-bbuilder release --project Bimer --version 11.3.1
-```
+## Configuração
 
-### Gerenciamento de projetos
-```bash
-bbuilder project list   # lista projetos configurados
-bbuilder project add    # adiciona novo projeto (interativo)
-bbuilder project remove # remove projeto (interativo ou por --name)
-```
+Crie a configuração inicial:
 
-### 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
+bbuilder config init
 ```
 
----
-
-## Configuração (`bbuilder.config.json`)
-
-Prioridade de resolução da configuração:
-
-1. `bbuilder --config <caminho>`
-2. Variável de ambiente `BBUILDER_CONFIG`
-3. `bbuilder.config.json` no diretório atual
-4. `bimer.config.json` no diretório atual, por compatibilidade
-5. Arquivo global do usuário
-
-No Windows, o arquivo global fica em `%APPDATA%\bbuilder-cli\bbuilder.config.json`.
-
-Crie com `bbuilder config init`, ou manualmente:
+Ou use um arquivo manual como este:
 
 ```json
 {
@@ -218,181 +53,129 @@ Crie com `bbuilder config init`, ou manualmente:
   ],
   "projects": {
     "BimerFaturamento": "faturamento\\BimerFaturamento",
-    "Bimer": "Bimer",
-    "LiberadorEstoque": "geral\\gerenteeletronico.jobs.liberadorestoque\\LiberadorEstoque",
-    "BimerEstoque": "estoque\\BimerEstoque"
+    "Bimer": "Bimer"
   }
 }
 ```
 
-`dependencyPaths` deve ser ajustado no `bbuilder.config.json`, porque esses caminhos podem variar entre usuários e máquinas.
-
-`projects` agora usa o formato `nome amigável: caminho real do projeto`, para a CLI exibir nomes humanizados sem perder a referência correta de compilação.
+`dependencyPaths` varia por máquina e deve ser ajustado por usuário.
 
-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.
+## Resolução da Configuração
 
-### Como usar configs locais
+Ordem de prioridade:
 
-O pacote é instalado normalmente, e a configuração é informada na execução, não na instalação.
+1. `--config <caminho>`
+2. variável de ambiente `BBUILDER_CONFIG`
+3. `bbuilder.config.json` no diretório atual
+4. `bimer.config.json` no diretório atual, por compatibilidade
+5. arquivo global do usuário
 
-Instalação global:
+No Windows, o arquivo global padrão fica em:
 
-```bash
-npm install -g @brunoluizdesiqueira/bbuilder-cli
+```text
+%APPDATA%\bbuilder-cli\bbuilder.config.json
 ```
 
-Usando um arquivo de config local explícito:
+Exemplos:
 
 ```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:
+## Uso
+
+Modo interativo:
 
-Se existir um `bbuilder.config.json` na pasta onde o comando é executado, a CLI usa esse arquivo automaticamente.
+```bash
+bbuilder
+```
 
-Para verificar qual arquivo está sendo usado:
+Build direto:
 
 ```bash
-bbuilder config show
+bbuilder build --type DEBUG --project BimerFaturamento --version 11.3.1
+bbuilder build --type FAST --project Bimer
+bbuilder build --type RELEASE --project Bimer
 ```
 
-Exemplos:
+Atalhos:
 
 ```bash
-bbuilder --config C:\configs\bbuilder.config.json build
+bbuilder fast
+bbuilder debug --project Bimer
+bbuilder release --project Bimer --version 11.3.1
 ```
 
+Projetos:
+
 ```bash
-set BBUILDER_CONFIG=C:\configs\bbuilder.config.json
+bbuilder project list
+bbuilder project add
+bbuilder project remove
+bbuilder project remove --name Bimer
+```
+
+Configuração:
+
+```bash
+bbuilder config init
 bbuilder config show
+bbuilder config validate
+bbuilder doctor
 ```
 
----
+## Observações de Uso
 
-## Integração com VSCode (`tasks.json`)
+- o build mostra etapas com tempo decorrido
+- `cgrc` e `dcc64` escrevem diretamente no terminal durante a compilação
+- no PowerShell, a saída do compilador pode ser menos verbosa que no `cmd`, mesmo com o build funcionando corretamente
 
-Substitua o `tasks.json` atual por este (sem mais menus do VSCode, a CLI cuida de tudo):
+Se o PowerShell bloquear `npm` ou `bbuilder`, ajuste a policy do usuário:
 
-```json
-{
-  "version": "2.0.0",
-  "tasks": [
-    {
-      "label": "Bimer: FAST + Run",
-      "type": "shell",
-      "command": "bbuilder fast",
-      "group": "build",
-      "presentation": { "reveal": "always", "focus": true, "panel": "dedicated", "clear": true },
-      "problemMatcher": {
-        "owner": "delphi",
-        "fileLocation": ["autoDetect", "${workspaceFolder}"],
-        "pattern": {
-          "regexp": "^(.*?)\\s*\\((\\d+)\\)(?:\\s+|:\\s*)(Fatal|Error|Warning|Hint|error|fatal):\\s+(.*)$",
-          "file": 1, "line": 2, "severity": 3, "message": 4
-        }
-      }
-    },
-    {
-      "label": "Bimer: DEBUG + Run",
-      "type": "shell",
-      "command": "bbuilder debug",
-      "group": "build",
-      "presentation": { "reveal": "always", "focus": true, "panel": "dedicated", "clear": true },
-      "problemMatcher": {
-        "owner": "delphi",
-        "fileLocation": ["autoDetect", "${workspaceFolder}"],
-        "pattern": {
-          "regexp": "^(.*?)\\s*\\((\\d+)\\)(?:\\s+|:\\s*)(Fatal|Error|Warning|Hint|error|fatal):\\s+(.*)$",
-          "file": 1, "line": 2, "severity": 3, "message": 4
-        }
-      }
-    },
-    {
-      "label": "Bimer: RELEASE",
-      "type": "shell",
-      "command": "bbuilder release",
-      "group": "build",
-      "presentation": { "reveal": "always", "focus": true, "panel": "dedicated", "clear": true },
-      "problemMatcher": {
-        "owner": "delphi",
-        "fileLocation": ["autoDetect", "${workspaceFolder}"],
-        "pattern": {
-          "regexp": "^(.*?)\\s*\\((\\d+)\\)(?:\\s+|:\\s*)(Fatal|Error|Warning|Hint|error|fatal):\\s+(.*)$",
-          "file": 1, "line": 2, "severity": 3, "message": 4
-        }
-      }
-    }
-  ]
-}
+```powershell
+Set-ExecutionPolicy -Scope CurrentUser RemoteSigned
 ```
 
-E nos keybindings, nada muda — os atalhos continuam os mesmos.
-
----
+## Troubleshooting
 
-## Estrutura do Projeto
+Validar ambiente:
 
+```bash
+bbuilder doctor
 ```
-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
+
+Validar configuração:
+
+```bash
+bbuilder config validate
 ```
 
-## Stack
+Erro `Unit not found: 'System'` normalmente indica problema em:
+- `delphiDir`
+- `dependencyPaths`
+- path `...\lib\Win64\release` ausente na configuração
+
+## Publicação
+
+Para usuários, nada além de instalar o pacote é necessário.
+
+Para mantenedores, o fluxo é:
+- criar changeset
+- abrir PR
+- mergear na `main`
+- mergear a PR automática de release
+- publicação no npm ocorre via GitHub Actions
+
+## Licença
 
-| Lib | Por quê |
-|---|---|
-| **commander** | Parsing de comandos e flags |
-| **inquirer** | Menus interativos com setas |
-| **chalk** | Cores ANSI no terminal |
-| **execa** | Spawn de processos externos (CGRC, DCC64) |
-| **typescript** | Tipagem, autocomplete, menos bugs |
+ISC

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@brunoluizdesiqueira/bbuilder-cli",
-  "version": "1.0.17",
+  "version": "1.0.18",
   "description": "CLI de build local para projetos Delphi do Bimer",
   "license": "ISC",
   "repository": {