pypeline 1.0.0

package/README.md

@@ -0,0 +1,448 @@
+# pypeline — SF CLI Plugin
+
+Pipeline DevOps Salesforce completo como plugin nativo do `sf` CLI. Orquestra build, geração de package.xml, validação em PRD e quick deploy a partir de um repositório git.
+
+---
+
+## Índice
+
+- [Pré-requisitos](#pré-requisitos)
+- [Instalação](#instalação)
+- [Configuração inicial](#configuração-inicial)
+- [Como buildar o plugin](#como-buildar-o-plugin)
+- [Comandos disponíveis](#comandos-disponíveis)
+- [Fluxo completo de uso](#fluxo-completo-de-uso)
+- [Testes](#testes)
+- [Estrutura do projeto](#estrutura-do-projeto)
+- [Solução de problemas](#solução-de-problemas)
+
+---
+
+## Pré-requisitos
+
+Antes de começar, certifique-se de ter instalado:
+
+- **Node.js** >= 18.0.0
+- **Yarn** (recomendado) ou npm
+- **Salesforce CLI** (`sf`) >= 2.x — instale com `npm install -g @salesforce/cli`
+- **Git** configurado no PATH
+- **Python 3** (apenas se você ainda usar os scripts `.py` originais em paralelo)
+
+Verifique as versões:
+
+```bash
+node --version    # deve ser >= 18
+sf --version      # deve ser >= 2
+git --version
+```
+
+---
+
+## Instalação
+
+### Opção 1 — Link local (desenvolvimento)
+
+É o modo recomendado enquanto você está desenvolvendo o plugin:
+
+```bash
+# 1. Entre na pasta do plugin
+cd pypeline
+
+# 2. Instale as dependências
+yarn install
+
+# 3. Compile o TypeScript
+yarn build
+
+# 4. Linke o plugin no sf CLI local
+sf plugins link .
+```
+
+Após o link, o plugin fica disponível globalmente no seu `sf`:
+
+```bash
+sf pypeline --help
+```
+
+Para atualizar o plugin após alterar código, recompile e o link já pega automaticamente:
+
+```bash
+yarn build
+```
+
+### Opção 2 — Instalação a partir de um diretório (sem publicar no npm)
+
+```bash
+sf plugins install /caminho/absoluto/para/pypeline
+```
+
+### Opção 3 — Publicar no npm e instalar
+
+```bash
+# Dentro da pasta do plugin
+npm publish
+
+# Em qualquer máquina
+sf plugins install pypeline
+```
+
+---
+
+## Configuração inicial
+
+Antes de usar o pipeline, você precisa de dois arquivos na pasta `workspace_bash`:
+
+### 1. `baseline.txt`
+
+Contém o hash do commit git que serve como ponto de partida do diff. O pipeline copia apenas os arquivos alterados **a partir desse commit**.
+
+```bash
+# Criar com o hash atual (ponto zero)
+git rev-parse HEAD > baseline.txt
+
+# Ou com um commit específico
+echo "abc1234def5678..." > baseline.txt
+```
+
+### 2. Autenticação das orgs no sf CLI
+
+O pipeline usa dois aliases de org por padrão:
+
+| Alias | Finalidade |
+|-------|-----------|
+| `devops` | Org de produção (PRD) |
+| `treino` | Org de treinamento |
+
+Autentique cada uma:
+
+```bash
+sf org login web --alias devops
+sf org login web --alias treino
+```
+
+Para usar aliases diferentes, passe as flags `--prd-org` e `--training-org` nos comandos.
+
+---
+
+## Como buildar o plugin
+
+O projeto usa **TypeScript** compilado via `tsc` com **wireit** para cache incremental.
+
+```bash
+# Build completo (compila + lint)
+yarn build
+
+# Apenas compilar TypeScript (mais rápido, sem lint)
+yarn compile
+
+# Limpar os artefatos de build
+yarn clean
+
+# Limpar tudo (incluindo node_modules)
+yarn clean-all
+```
+
+Os arquivos compilados ficam em `lib/` — é o que o sf CLI carrega em produção.
+
+> **Atenção:** nunca edite arquivos em `lib/` diretamente. Sempre edite em `src/` e recompile.
+
+---
+
+## Comandos disponíveis
+
+### `sf pypeline run` — Pipeline completo
+
+Executa todas as 4 etapas em sequência. O deploy em Training roda em paralelo ao validate PRD. Em caso de falha em qualquer etapa, faz rollback automático do `baseline.txt`.
+
+```bash
+# Execução padrão
+sf pypeline run
+
+# Com branch customizada
+sf pypeline run --branch release-v5.0.0
+
+# Pulando o deploy em Training
+sf pypeline run --skip-training
+
+# Com orgs customizadas
+sf pypeline run --prd-org minha-producao --training-org minha-homolog
+
+# Simulando o build sem copiar arquivos
+sf pypeline run --dry-run
+```
+
+**Flags disponíveis:**
+
+| Flag | Padrão | Descrição |
+|------|--------|-----------|
+| `--branch, -b` | valor em `config.ts` | Branch git para checkout no build |
+| `--skip-training` | `false` | Pula o deploy em Training |
+| `--dry-run` | `false` | Simula o build sem tocar em arquivos |
+| `--prd-org` | `devops` | Alias da org de produção |
+| `--training-org` | `treino` | Alias da org de treinamento |
+
+---
+
+### `sf pypeline build` — Etapa 1
+
+Faz checkout da branch, git pull, calcula o diff desde o baseline e copia os arquivos alterados para a pasta `build_deploy/`.
+
+```bash
+sf pypeline build
+sf pypeline build --branch release-v5.0.0
+sf pypeline build --dry-run
+```
+
+Arquivos gerados após a execução:
+
+```
+workspace_bash/
+├── build_deploy/          ← pasta com os arquivos do deploy
+├── commitlist.txt         ← lista de commits desde o baseline
+├── lista_arquivos_adicionados.txt
+├── lista_arquivos_modificados.txt
+├── lista_arquivos_deletados.txt
+└── lista_arquivos_naodeletados.txt
+```
+
+---
+
+### `sf pypeline package` — Etapa 2
+
+Gera o `package.xml` a partir da pasta de build usando `sf project generate manifest`.
+
+```bash
+sf pypeline package
+```
+
+---
+
+### `sf pypeline deploy training` — Etapa 3
+
+Deploy na org de treinamento com `RunLocalTests`. Grava output em `deploy_training_output.log`.
+
+```bash
+sf pypeline deploy training
+sf pypeline deploy training --target-org minha-org-treino
+sf pypeline deploy training --wait 120
+```
+
+| Flag | Padrão | Descrição |
+|------|--------|-----------|
+| `--target-org, -o` | `treino` | Alias da org de treinamento |
+| `--wait, -w` | `240` | Minutos de espera pelo resultado |
+
+---
+
+### `sf pypeline validate prd` — Etapa 4
+
+Valida o deploy em produção (sem efetivá-lo). Extrai o Job ID do output e salva em `prd_job_id.txt`. Grava output em `deploy_prd_output.log`.
+
+```bash
+sf pypeline validate prd
+sf pypeline validate prd --target-org minha-producao
+```
+
+| Flag | Padrão | Descrição |
+|------|--------|-----------|
+| `--target-org, -o` | `devops` | Alias da org de produção |
+| `--wait, -w` | `240` | Minutos de espera pela validação |
+
+---
+
+### `sf pypeline quickdeploy` — Quick deploy
+
+Executa o quick deploy em produção usando o Job ID salvo. O Job ID expira **10 horas** após o validate. Remove `prd_job_id.txt` após sucesso para evitar reuso.
+
+```bash
+# Lê o Job ID de prd_job_id.txt automaticamente
+sf pypeline quickdeploy
+
+# Passando o Job ID diretamente (sem precisar do arquivo)
+sf pypeline quickdeploy --job-id 0Af000000000001AAA
+
+# Sem confirmação interativa (para CI/CD)
+sf pypeline quickdeploy --no-prompt
+```
+
+| Flag | Padrão | Descrição |
+|------|--------|-----------|
+| `--target-org, -o` | `devops` | Alias da org de produção |
+| `--job-id, -j` | lê do arquivo | Job ID da validação |
+| `--wait, -w` | `240` | Minutos de espera |
+| `--no-prompt` | `false` | Pula a confirmação interativa |
+
+---
+
+## Fluxo completo de uso
+
+### Fluxo padrão (recomendado)
+
+```bash
+# 1. Execute o pipeline completo
+sf pypeline run
+
+# 2. Quando o pipeline terminar com sucesso, o Job ID fica salvo.
+#    Execute o quick deploy (feito pelo time de PRD):
+sf pypeline quickdeploy
+```
+
+### Fluxo manual (etapa por etapa)
+
+Útil para depurar ou reexecutar apenas uma etapa:
+
+```bash
+# Etapa 1: build
+sf pypeline build
+
+# Etapa 2: gerar package.xml
+sf pypeline package
+
+# Etapa 3: deploy em Training (em background, se quiser)
+sf pypeline deploy training &
+
+# Etapa 4: validar em PRD (síncrono)
+sf pypeline validate prd
+
+# Após validação bem-sucedida:
+sf pypeline quickdeploy
+```
+
+### Fluxo com rollback
+
+Se qualquer etapa do `sf pypeline run` falhar, o `baseline.txt` é restaurado automaticamente para o valor anterior. Nenhuma alteração é promovida.
+
+Você pode verificar o motivo da falha nos logs:
+
+```bash
+cat deploy_prd_output.log
+cat deploy_training_output.log
+```
+
+---
+
+## Testes
+
+### Instalar dependências de teste
+
+As dependências de teste (mocha, sinon, chai, nyc) já estão no `package.json`. Basta instalar:
+
+```bash
+yarn install
+```
+
+### Rodar os unit tests
+
+Rápidos, sem necessidade de org ou internet. Testam toda a lógica do plugin com mocks.
+
+```bash
+# Rodar unit tests
+yarn test:only
+
+# Rodar com relatório de cobertura (exige >= 90%)
+yarn test:coverage
+```
+
+O relatório de cobertura é gerado em `coverage/lcov-report/index.html`.
+
+### Rodar todos os testes (unit + lint + type-check)
+
+```bash
+yarn test
+```
+
+### Rodar os NUT tests (integração com org real)
+
+Os NUT tests rodam o plugin de verdade contra uma org Salesforce. São lentos e opcionais.
+
+```bash
+# NUTs básicos (build + package — não tocam em nenhuma org)
+NUT_ORG_ALIAS=treino yarn test:nuts
+
+# Habilitar o validate prd no NUT (cuidado: roda contra a org real)
+RUN_VALIDATE_NUT=1 NUT_ORG_ALIAS=treino yarn test:nuts
+
+# Habilitar o quick deploy no NUT (só roda se prd_job_id.txt existir)
+RUN_QUICKDEPLOY_NUT=1 NUT_ORG_ALIAS=treino yarn test:nuts
+```
+
+> **Atenção:** nunca sete `RUN_VALIDATE_NUT` ou `RUN_QUICKDEPLOY_NUT` em pipelines de CI/CD automáticos sem revisão, pois esses testes fazem operações reais em orgs Salesforce.
+
+### Estrutura dos testes
+
+```
+test/
+├── helpers.ts                              ← stubs reutilizáveis (fs, spawn, git)
+├── unit/
+│   ├── config.test.ts                      ← readFileTrimmed, gitDiffFiles...
+│   ├── fileUtils.test.ts                   ← cleanFilename, copyFile
+│   └── commands/pypeline/
+│       ├── build.test.ts
+│       ├── package.test.ts
+│       ├── quickdeploy.test.ts
+│       ├── run.test.ts                     ← rollback, paralelismo, flags
+│       ├── deploy/training.test.ts
+│       └── validate/prd.test.ts            ← extração do Job ID
+└── nuts/
+    └── pypeline.nut.ts                     ← testes contra org real
+```
+
+---
+
+## Estrutura do projeto
+
+```
+pypeline/
+├── src/
+│   ├── config.ts                     ← caminhos, constantes, utilitários git/fs
+│   ├── fileUtils.ts                  ← lógica de cópia de arquivos Salesforce
+│   └── commands/pypeline/
+│       ├── run.ts                    ← sf pypeline run
+│       ├── build.ts                  ← sf pypeline build
+│       ├── package.ts                ← sf pypeline package
+│       ├── quickdeploy.ts            ← sf pypeline quickdeploy
+│       ├── deploy/
+│       │   └── training.ts           ← sf pypeline deploy training
+│       └── validate/
+│           └── prd.ts                ← sf pypeline validate prd
+├── messages/
+│   ├── pypeline.run.md
+│   ├── pypeline.build.md
+│   ├── pypeline.package.md
+│   ├── pypeline.quickdeploy.md
+│   ├── pypeline.deploy.training.md
+│   └── pypeline.validate.prd.md
+├── test/
+│   ├── helpers.ts
+│   ├── unit/
+│   └── nuts/
+├── lib/                              ← compilado pelo tsc (não editar)
+├── .mocharc.json                     ← configuração do runner de testes
+├── .nycrc                            ← configuração de cobertura (mínimo 90%)
+├── package.json
+└── tsconfig.json
+```
+
+---
+
+## Solução de problemas
+
+**`sf: command not found` ao linkar o plugin**
+
+Verifique se o sf CLI está instalado globalmente: `npm install -g @salesforce/cli`
+
+**`Pasta raiz 'workspace_bash' não encontrada`**
+
+O `config.ts` sobe na árvore de diretórios procurando uma pasta chamada `workspace_bash`. Certifique-se de que o plugin está dentro dessa estrutura ou ajuste o `marker` em `src/config.ts`.
+
+**`baseline.txt não encontrado`**
+
+Crie o arquivo com `git rev-parse HEAD > baseline.txt` na raiz de `workspace_bash`.
+
+**Job ID não encontrado após o validate**
+
+O Job ID é extraído por regex do output do `sf project deploy validate`. Se o formato do output mudar em versões futuras do sf CLI, ajuste o pattern `0Af[0-9A-Za-z]{15}` em `src/commands/pypeline/validate/prd.ts`.
+
+**Cobertura abaixo de 90%**
+
+Rode `yarn test:coverage` para ver o relatório detalhado e identificar quais linhas não estão cobertas. O limite mínimo está configurado em `.nycrc`.

package/lib/commands/pypeline/build.d.ts

@@ -0,0 +1,18 @@
+import { SfCommand } from '@salesforce/sf-plugins-core';
+export type PypelineBuildResult = {
+    commitHash: string;
+    novoBaseline: string;
+    added: string[];
+    modified: string[];
+    deleted: string[];
+};
+export default class PypelineBuild extends SfCommand<PypelineBuildResult> {
+    static readonly summary: string;
+    static readonly description: string;
+    static readonly examples: string[];
+    static readonly flags: {
+        branch: import("@oclif/core/interfaces").OptionFlag<string, import("@oclif/core/interfaces").CustomOptions>;
+        'dry-run': import("@oclif/core/interfaces").BooleanFlag<boolean>;
+    };
+    run(): Promise<PypelineBuildResult>;
+}

package/lib/commands/pypeline/build.js

@@ -0,0 +1,86 @@
+import { execSync, spawnSync } from 'node:child_process';
+import * as fs from 'node:fs';
+import * as path from 'node:path';
+import { SfCommand, Flags } from '@salesforce/sf-plugins-core';
+import { Messages } from '@salesforce/core';
+import { BASELINE_FILE, BRANCH, BUILD_DIR, PROJECT_DIR, PROJECT_NAME, SCRIPT_DIR, fileExists, readFileTrimmed, writeFile, gitDiffFiles, } from '../../config.js';
+import { copyFile } from '../../fileUtils.js';
+Messages.importMessagesDirectoryFromMetaUrl(import.meta.url);
+const messages = Messages.loadMessages('pypeline', 'pypeline.build');
+export default class PypelineBuild extends SfCommand {
+    static summary = messages.getMessage('summary');
+    static description = messages.getMessage('description');
+    static examples = messages.getMessages('examples');
+    static flags = {
+        branch: Flags.string({
+            char: 'b',
+            summary: messages.getMessage('flags.branch.summary'),
+            default: BRANCH,
+        }),
+        'dry-run': Flags.boolean({
+            summary: messages.getMessage('flags.dry-run.summary'),
+            default: false,
+        }),
+    };
+    async run() {
+        const { flags } = await this.parse(PypelineBuild);
+        const branch = flags['branch'];
+        const dryRun = flags['dry-run'];
+        this.log(`SCRIPT_DIR  : ${SCRIPT_DIR}`);
+        this.log(`PROJECT_DIR : ${PROJECT_DIR()}`);
+        if (!dryRun) {
+            const gen = spawnSync('sf', ['project', 'generate', '--name', PROJECT_NAME, '--output-dir', PROJECT_DIR()], {
+                encoding: 'utf8',
+                stdio: 'inherit',
+            });
+            if (gen.status !== 0)
+                this.error('Falha ao gerar estrutura do projeto sf.');
+        }
+        if (!fileExists(BASELINE_FILE()))
+            this.error('baseline.txt não encontrado!');
+        const commitHash = readFileTrimmed(BASELINE_FILE());
+        this.log(`Baseline : ${commitHash}`);
+        if (!dryRun) {
+            for (const cmd of [
+                ['git', 'checkout', branch ?? BRANCH],
+                ['git', 'fetch'],
+                ['git', 'pull'],
+            ]) {
+                const r = spawnSync(cmd[0], cmd.slice(1), { stdio: 'inherit' });
+                if (r.status !== 0)
+                    this.error(`Falha ao executar: ${cmd.join(' ')}`);
+            }
+        }
+        const commits = execSync(`git rev-list ${commitHash}..HEAD --oneline`, { encoding: 'utf8' });
+        writeFile(path.join(PROJECT_DIR(), 'commitlist.txt'), commits);
+        if (fs.existsSync(BUILD_DIR()))
+            fs.rmSync(BUILD_DIR(), { recursive: true, force: true });
+        fs.mkdirSync(BUILD_DIR(), { recursive: true });
+        const diff = gitDiffFiles(commitHash);
+        writeFile(path.join(PROJECT_DIR(), 'lista_arquivos_naodeletados.txt'), diff.notDeleted.join('\n'));
+        writeFile(path.join(PROJECT_DIR(), 'lista_arquivos_deletados.txt'), diff.deleted.join('\n'));
+        writeFile(path.join(PROJECT_DIR(), 'lista_arquivos_adicionados.txt'), diff.added.join('\n'));
+        writeFile(path.join(PROJECT_DIR(), 'lista_arquivos_modificados.txt'), diff.modified.join('\n'));
+        this.log('Arquivos modificados ou adicionados:');
+        for (const file of diff.notDeleted) {
+            this.log(`  Arquivo a ser avaliado: ${file}`);
+            if (!dryRun) {
+                try {
+                    copyFile(file, BUILD_DIR());
+                }
+                catch (err) {
+                    this.warn(`Erro ao copiar '${file}': ${err.message}`);
+                }
+            }
+        }
+        const novoBaseline = execSync('git rev-parse HEAD', { encoding: 'utf8' }).trim();
+        this.log(`[INFO] Novo baseline calculado: ${novoBaseline}`);
+        this.log('[INFO] baseline.txt será atualizado pelo comando run após validate PRD.');
+        process.env['NOVO_BASELINE'] = novoBaseline;
+        const branchInfo = execSync('git branch', { encoding: 'utf8' });
+        this.log(`Branches:\n${branchInfo}`);
+        this.log(`Build project criado em ${BUILD_DIR()}.`);
+        return { commitHash, novoBaseline, added: diff.added, modified: diff.modified, deleted: diff.deleted };
+    }
+}
+//# sourceMappingURL=build.js.map

package/lib/commands/pypeline/build.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"build.js","sourceRoot":"","sources":["../../../src/commands/pypeline/build.ts"],"names":[],"mappings":"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"}

package/lib/commands/pypeline/deploy/training.d.ts

@@ -0,0 +1,15 @@
+import { SfCommand } from '@salesforce/sf-plugins-core';
+export type PypelineDeployTrainingResult = {
+    success: boolean;
+    logPath: string;
+};
+export default class PypelineDeployTraining extends SfCommand<PypelineDeployTrainingResult> {
+    static readonly summary: string;
+    static readonly description: string;
+    static readonly examples: string[];
+    static readonly flags: {
+        'target-org': import("@oclif/core/interfaces").OptionFlag<string, import("@oclif/core/interfaces").CustomOptions>;
+        wait: import("@oclif/core/interfaces").OptionFlag<number, import("@oclif/core/interfaces").CustomOptions>;
+    };
+    run(): Promise<PypelineDeployTrainingResult>;
+}

package/lib/commands/pypeline/deploy/training.js

@@ -0,0 +1,62 @@
+import { spawn } from 'node:child_process';
+import * as fs from 'node:fs';
+import { SfCommand, Flags } from '@salesforce/sf-plugins-core';
+import { Messages } from '@salesforce/core';
+import { LOG_TRAINING, SOURCE_DIR, unlinkIfExists } from '../../../config.js';
+Messages.importMessagesDirectoryFromMetaUrl(import.meta.url);
+const messages = Messages.loadMessages('pypeline', 'pypeline.deploy.training');
+export default class PypelineDeployTraining extends SfCommand {
+    static summary = messages.getMessage('summary');
+    static description = messages.getMessage('description');
+    static examples = messages.getMessages('examples');
+    static flags = {
+        'target-org': Flags.string({
+            summary: messages.getMessage('flags.target-org.summary'),
+            default: 'treino',
+        }),
+        wait: Flags.integer({
+            char: 'w',
+            summary: messages.getMessage('flags.wait.summary'),
+            default: 240,
+        }),
+    };
+    async run() {
+        const { flags } = await this.parse(PypelineDeployTraining);
+        const logPath = LOG_TRAINING();
+        const sourceDir = SOURCE_DIR();
+        unlinkIfExists(logPath);
+        this.log('Iniciando deploy em Training...');
+        const cmd = [
+            'project', 'deploy', 'start',
+            '--source-dir', sourceDir,
+            '--target-org', flags['target-org'] ?? 'treino',
+            '--test-level', 'RunLocalTests',
+            '-w', String(flags['wait'] ?? 240),
+            '--ignore-conflicts',
+            '--verbose',
+        ];
+        const exitCode = await new Promise((resolve) => {
+            const proc = spawn('sf', cmd, { stdio: ['inherit', 'pipe', 'pipe'] });
+            const log = fs.createWriteStream(logPath, { flags: 'a' });
+            if (proc.stdout)
+                proc.stdout.on('data', (chunk) => {
+                    const text = chunk.toString();
+                    process.stdout.write(text);
+                    log.write(text);
+                });
+            if (proc.stderr)
+                proc.stderr.on('data', (chunk) => {
+                    const text = chunk.toString();
+                    process.stderr.write(text);
+                    log.write(text);
+                });
+            proc.on('close', (code) => { log.close(); resolve(code ?? 1); });
+        });
+        if (exitCode !== 0) {
+            this.error(`Deploy em Training falhou com exit code ${exitCode}.`);
+        }
+        this.log('Deploy em Training concluído com sucesso.');
+        return { success: true, logPath };
+    }
+}
+//# sourceMappingURL=training.js.map

package/lib/commands/pypeline/deploy/training.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"training.js","sourceRoot":"","sources":["../../../../src/commands/pypeline/deploy/training.ts"],"names":[],"mappings":"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"}

package/lib/commands/pypeline/package.d.ts

@@ -0,0 +1,11 @@
+import { SfCommand } from '@salesforce/sf-plugins-core';
+export type PypelinePackageResult = {
+    success: boolean;
+    buildDir: string;
+};
+export default class PypelinePackage extends SfCommand<PypelinePackageResult> {
+    static readonly summary: string;
+    static readonly description: string;
+    static readonly examples: string[];
+    run(): Promise<PypelinePackageResult>;
+}

package/lib/commands/pypeline/package.js

@@ -0,0 +1,27 @@
+import { spawn } from 'node:child_process';
+import { SfCommand } from '@salesforce/sf-plugins-core';
+import { Messages } from '@salesforce/core';
+import { BUILD_DIR } from '../../config.js';
+Messages.importMessagesDirectoryFromMetaUrl(import.meta.url);
+const messages = Messages.loadMessages('pypeline', 'pypeline.package');
+export default class PypelinePackage extends SfCommand {
+    static summary = messages.getMessage('summary');
+    static description = messages.getMessage('description');
+    static examples = messages.getMessages('examples');
+    async run() {
+        const buildDir = BUILD_DIR();
+        this.log('Gerando package.xml...');
+        const exitCode = await new Promise((resolve) => {
+            const proc = spawn('sf', ['project', 'generate', 'manifest', '--source-dir', buildDir], {
+                stdio: 'inherit',
+            });
+            proc.on('close', (code) => resolve(code ?? 1));
+        });
+        if (exitCode !== 0) {
+            this.error('Falha ao gerar package.xml.');
+        }
+        this.log('package.xml gerado com sucesso.');
+        return { success: true, buildDir };
+    }
+}
+//# sourceMappingURL=package.js.map