@oktis-works/cms 0.1.14 → 0.2.0

package/dist/bluegreen.d.ts

@@ -0,0 +1,121 @@
+import { type Lane } from './assets.js';
+import { type Runner } from './docker.js';
+/** O que o operador escolheu no wizard (ou que as flags decidiram). */
+export interface DeployChoices {
+    /** `docker compose build --no-cache` — build limpo, mais lento. */
+    noCache: boolean;
+    /** `down --remove-orphans` na lane antiga. */
+    removeOrphans: boolean;
+}
+export interface DeployOptions {
+    cwd?: string;
+    runner?: Runner;
+    log?: (message: string) => void;
+    warn?: (message: string) => void;
+    /** `pkg@latest` a instalar no host antes do build (vem do scan do update). */
+    packages?: string[];
+    /**
+     * Projeto sem `node_modules` (clone novo): roda `bun install` no passo de
+     * pacotes em vez de `bun add` — o `db:migrate` do host precisa das deps.
+     */
+    installAll?: boolean;
+    choices: DeployChoices;
+    /**
+     * Verificação final pelo proxy (porta 80). Falha aqui é AVISO, não rollback:
+     * o gate autoritativo é o healthcheck de cada contêiner da lane, feito
+     * dentro da rede antes do swap.
+     */
+    healthProbe?: (url: string) => Promise<boolean>;
+    /**
+     * Timeouts por passo. Exposto para os testes rodarem em milissegundos —
+     * em produção os defaults de 3 min é o que cabe um pull de imagem fria.
+     */
+    timeouts?: DeployTimeouts;
+}
+export interface DeployTimeouts {
+    /** healthcheck de postgres/redis (puxa imagem no primeiro deploy). */
+    dataMs?: number;
+    /** healthcheck dos contêineres de edge da lane nova. */
+    edgeMs?: number;
+    /** espera do SIGTERM do worker antigo (depois do stop_grace_period). */
+    stopMs?: number;
+    /** intervalo de sondagem em geral. */
+    intervalMs?: number;
+}
+export declare const DEFAULT_TIMEOUTS: Required<DeployTimeouts>;
+export interface DeployResult {
+    ok: boolean;
+    /** Lane servindo ao final. Em falha, a lane que continuou no ar. */
+    lane: Lane;
+    previousLane: Lane | null;
+    /** Arquivos de deploy criados neste passo (nunca sobrescreve os existentes). */
+    created: string[];
+    message?: string;
+}
+export declare const EDGE_SERVICE: (lane: Lane) => string[];
+export declare const WORKER_SERVICE: (lane: Lane) => string;
+/** URL final da checagem através do proxy. */
+export declare const FINAL_HEALTH_URL = "http://127.0.0.1/health";
+export declare function loadDeployEnv(cwd: string): Record<string, string>;
+/**
+ * Grava os arquivos de deploy que faltarem, preservando os que já existem.
+ *
+ * Não decide nada sobre estado: quem chama diz a `lane` inicial. Isso é o que
+ * permite o `okcms init` usá-lo sem tocar no Docker (o `ensureDeployFiles` do
+ * deploy, logo abaixo, é que consulta a lane ativa).
+ */
+export declare function writeDeployAssets(cwd: string, lane: Lane, record: Record<string, string>): string[];
+/**
+ * Cria os arquivos de deploy que faltarem, preservando os que já existem.
+ * Um projeto anterior ao deploy-in-Docker ganha os arquivos aqui mesmo —
+ * pedir que o operador rode um outro comando só para criar config é atrito.
+ * A lane ativa vem do estado salvo (ou do Docker, em último caso).
+ */
+export declare function ensureDeployFiles(cwd: string, record?: Record<string, string>, runner?: Runner): string[];
+export interface LaneServices {
+    edge: string[];
+    worker: string[];
+}
+/**
+ * Nomes de serviço da lane, lidos do compose real.
+ *
+ * O fallback só existe para o caso de o arquivo ter sido editado até sumir os
+ * papéis — aí as convenções `api-<lane>` seguram o fluxo em vez de explodir
+ * no meio de um deploy.
+ */
+export declare function laneServices(cwd: string, lane: Lane): LaneServices;
+export interface PreflightResult {
+    ok: boolean;
+    message?: string;
+}
+/**
+ * Tudo o que precisa ser verdade ANTES de qualquer `docker compose up`.
+ * Fazer isso no meio do fluxo deixaria o projeto com a rede criada, a infra
+ * no ar e a build parada — pior do que não ter começado.
+ */
+export declare function preflight(runner?: Runner): PreflightResult;
+export declare const workerContainer: (lane: Lane) => string;
+export declare const edgeContainerNames: (lane: Lane) => string[];
+export interface LaneContainers {
+    edge: string[];
+    worker: string[];
+}
+/**
+ * Nomes de CONTAINER (não de serviço) da lane, lidos do compose quando
+ * possível: é o que o `docker inspect` entende no healthcheck e no dreno.
+ */
+export declare function laneContainers(cwd: string, lane: Lane): LaneContainers;
+/**
+ * Como invocar o próprio `okcms db:migrate`.
+ *
+ * Reexecuta o MESMO binário que está rodando (argv[1]) em vez de depender de
+ * PATH/npx: o caminho do projeto instalado é o único que tem as migrations e
+ * o `.env` certos, e o host é onde elas devem correr (o container não tem a
+ * CLI, por construção).
+ */
+export declare function migrateInvocation(): {
+    command: string;
+    args: string[];
+};
+export declare function deployBlueGreen(opts: DeployOptions): Promise<DeployResult>;
+//# sourceMappingURL=bluegreen.d.ts.map

package/dist/bluegreen.d.ts.map

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

package/dist/bluegreen.js

@@ -0,0 +1,393 @@
+// @oktis-works/cms - Deploy blue/green (F3)
+//
+// O contrato de ordem é o produto deste arquivo. Cada passo existe porque
+// inverter a ordem quebra alguma coisa concreta:
+//
+//   1. arquivos de deploy   → sem docker-compose.deploy.yml não há o que subir
+//   2. preflight            → docker/compose ausente detectado ANTES de mexer
+//   3. rede + infra         → a lane depende de okcms-net, postgres e redis
+//   4. pacotes no host      → o db:migrate do passo 6 roda com o pacote novo
+//   5. build da lane nova   → imagem nova ainda sem tráfego
+//   6. db:migrate NO HOST   → entre build e tráfego; falhou = nada mudou
+//   7. sobe edge da lane    → contêineres prontos antes do proxy apontar
+//   8. healthcheck          → gate real do blue/green: falhou = rollback
+//   9. swap do nginx        → 3 linhas + `nginx -s reload` (conexões vivas)
+//  10. drena worker antigo  → SIGTERM + stop_grace_period, ANTES do novo subir
+//  11. sobe worker novo     → nunca duas filas consumindo ao mesmo tempo
+//  12. derruba lane antiga  → `down` SEM -v: o volume de mídia é compartilhado
+//
+// A CLI NUNCA roda dentro do container (ver `assertHostOnly`): o deploy é
+// sempre a partir do host, contra o socket do Docker local.
+import { existsSync, mkdirSync, readFileSync, writeFileSync } from 'node:fs';
+import { dirname, join } from 'node:path';
+import { deployAssets, portsFromEnv } from './assets.js';
+import { COMPOSE_DEPLOY_FILE, classifyServices, composeAvailable, defaultRunner, detectActiveLane, dockerAvailable, ensureNetwork, infraCompose, isHealthy, laneCompose, otherLane, parseComposeServices, pushLaneState, readLaneState, readUpstreamsLane, reloadProxy, restartProxy, waitStopped, waitForContainer, writeLaneState, writeUpstreams, } from './docker.js';
+import { loadEnvFile } from './env-file.js';
+export const DEFAULT_TIMEOUTS = {
+    dataMs: 180_000,
+    edgeMs: 180_000,
+    stopMs: 60_000,
+    intervalMs: 2_000,
+};
+export const EDGE_SERVICE = (lane) => [
+    `api-${lane}`,
+    `web-${lane}`,
+    `admin-${lane}`,
+];
+export const WORKER_SERVICE = (lane) => `worker-${lane}`;
+/** URL final da checagem através do proxy. */
+export const FINAL_HEALTH_URL = 'http://127.0.0.1/health';
+async function defaultHealthProbe(url) {
+    const controller = new AbortController();
+    const timer = setTimeout(() => controller.abort(), 5_000);
+    try {
+        const response = await fetch(url, { signal: controller.signal });
+        return response.ok;
+    }
+    catch {
+        return false;
+    }
+    finally {
+        clearTimeout(timer);
+    }
+}
+// ---------------------------------------------------------------------------
+// Arquivos de deploy
+// ---------------------------------------------------------------------------
+export function loadDeployEnv(cwd) {
+    return loadEnvFile(join(cwd, '.env')).toRecord();
+}
+/**
+ * Grava os arquivos de deploy que faltarem, preservando os que já existem.
+ *
+ * Não decide nada sobre estado: quem chama diz a `lane` inicial. Isso é o que
+ * permite o `okcms init` usá-lo sem tocar no Docker (o `ensureDeployFiles` do
+ * deploy, logo abaixo, é que consulta a lane ativa).
+ */
+export function writeDeployAssets(cwd, lane, record) {
+    const created = [];
+    for (const asset of deployAssets(lane, portsFromEnv(record))) {
+        const path = join(cwd, asset.path);
+        if (existsSync(path))
+            continue;
+        mkdirSync(dirname(path), { recursive: true });
+        writeFileSync(path, asset.content, { encoding: 'utf-8', mode: asset.mode ?? 0o644 });
+        created.push(asset.path);
+    }
+    return created;
+}
+/**
+ * Cria os arquivos de deploy que faltarem, preservando os que já existem.
+ * Um projeto anterior ao deploy-in-Docker ganha os arquivos aqui mesmo —
+ * pedir que o operador rode um outro comando só para criar config é atrito.
+ * A lane ativa vem do estado salvo (ou do Docker, em último caso).
+ */
+export function ensureDeployFiles(cwd, record = loadDeployEnv(cwd), runner) {
+    const active = detectActiveLane(cwd, runner);
+    return writeDeployAssets(cwd, active ?? 'blue', record);
+}
+/**
+ * Nomes de serviço da lane, lidos do compose real.
+ *
+ * O fallback só existe para o caso de o arquivo ter sido editado até sumir os
+ * papéis — aí as convenções `api-<lane>` seguram o fluxo em vez de explodir
+ * no meio de um deploy.
+ */
+export function laneServices(cwd, lane) {
+    const file = join(cwd, COMPOSE_DEPLOY_FILE);
+    if (existsSync(file)) {
+        const parsed = classifyServices(parseComposeServices(readFileSync(file, 'utf-8')), lane);
+        if (parsed.edge.length > 0 || parsed.worker.length > 0) {
+            return {
+                edge: parsed.edge.map((service) => service.name),
+                worker: parsed.worker.map((service) => service.name),
+            };
+        }
+    }
+    return { edge: EDGE_SERVICE(lane), worker: [WORKER_SERVICE(lane)] };
+}
+/**
+ * Tudo o que precisa ser verdade ANTES de qualquer `docker compose up`.
+ * Fazer isso no meio do fluxo deixaria o projeto com a rede criada, a infra
+ * no ar e a build parada — pior do que não ter começado.
+ */
+export function preflight(runner = defaultRunner) {
+    if (!dockerAvailable(runner)) {
+        return {
+            ok: false,
+            message: 'Docker não está acessível.\n' +
+                '  Instale o Docker Desktop/Engine e confira `docker version`.\n' +
+                '  Sem ele, use `okcms update --mode download` para só baixar os pacotes.',
+        };
+    }
+    const compose = composeAvailable(runner);
+    if (!compose.ok) {
+        return {
+            ok: false,
+            message: 'Docker Compose v2 não está disponível (`docker compose version` falhou).\n' +
+                '  O deploy usa o plugin Compose v2 — o `docker-compose` legado (v1, Python)\n' +
+                '  não entende healthcheck nem extensões `x-` dos arquivos gerados.',
+        };
+    }
+    return { ok: true };
+}
+// ---------------------------------------------------------------------------
+// Convenções de nome (espelham container_name do compose)
+// ---------------------------------------------------------------------------
+export const workerContainer = (lane) => `okcms-${WORKER_SERVICE(lane)}`;
+export const edgeContainerNames = (lane) => EDGE_SERVICE(lane).map((service) => `okcms-${service}`);
+/**
+ * Nomes de CONTAINER (não de serviço) da lane, lidos do compose quando
+ * possível: é o que o `docker inspect` entende no healthcheck e no dreno.
+ */
+export function laneContainers(cwd, lane) {
+    const file = join(cwd, COMPOSE_DEPLOY_FILE);
+    if (existsSync(file)) {
+        const matched = parseComposeServices(readFileSync(file, 'utf-8')).filter((service) => service.lane === lane && (service.role === 'edge' || service.role === 'worker'));
+        if (matched.length > 0) {
+            return {
+                edge: matched.filter((s) => s.role === 'edge').map((s) => s.containerName),
+                worker: matched.filter((s) => s.role === 'worker').map((s) => s.containerName),
+            };
+        }
+    }
+    return { edge: edgeContainerNames(lane), worker: [workerContainer(lane)] };
+}
+/**
+ * Como invocar o próprio `okcms db:migrate`.
+ *
+ * Reexecuta o MESMO binário que está rodando (argv[1]) em vez de depender de
+ * PATH/npx: o caminho do projeto instalado é o único que tem as migrations e
+ * o `.env` certos, e o host é onde elas devem correr (o container não tem a
+ * CLI, por construção).
+ */
+export function migrateInvocation() {
+    const entry = process.argv[1];
+    if (entry)
+        return { command: process.execPath, args: [entry, 'db:migrate'] };
+    return { command: 'npx', args: ['okcms', 'db:migrate'] };
+}
+/** `bun add` com queda para `npm install` quando o bun não existe no host. */
+function installPackages(cwd, packages, runner) {
+    const bun = runner('bun', ['add', ...packages], { cwd, inherit: true, timeoutMs: 600_000 });
+    if (bun.ok || !/ENOENT|not found|spawn/i.test(bun.stderr))
+        return bun;
+    return runner('npm', ['install', ...packages], { cwd, inherit: true, timeoutMs: 600_000 });
+}
+// ---------------------------------------------------------------------------
+// Deploy
+// ---------------------------------------------------------------------------
+export async function deployBlueGreen(opts) {
+    const cwd = opts.cwd ?? process.cwd();
+    const runner = opts.runner ?? defaultRunner;
+    const log = opts.log ?? ((message) => void console.log(message));
+    const warn = opts.warn ?? ((message) => void console.warn(message));
+    const choices = opts.choices;
+    const packages = opts.packages ?? [];
+    const probe = opts.healthProbe ?? defaultHealthProbe;
+    const timeout = { ...DEFAULT_TIMEOUTS, ...opts.timeouts };
+    const record = loadDeployEnv(cwd);
+    const created = ensureDeployFiles(cwd, record, runner);
+    // Quem serve hoje decide para QUAL lane vamos: sempre para a outra, para
+    // que a rollback exista. Primeira execução (sem estado) = sem rollback.
+    const previous = detectActiveLane(cwd, runner);
+    const target = previous ? otherLane(previous) : (readUpstreamsLane(cwd) ?? 'blue');
+    const willDrain = previous !== null;
+    const plan = [
+        'Preflight: docker + compose v2',
+        'Rede okcms-net e infraestrutura (postgres, redis, proxy)',
+        'Baixar pacotes no host',
+        'Build da imagem (lane nova, sem tráfego)',
+        'Migrations no host',
+        `Subir edge da lane ${target}`,
+        `Healthcheck da lane ${target}`,
+        'Swap do proxy (nginx -s reload)',
+        ...(willDrain ? [`Drenar worker da lane ${previous}`] : []),
+        `Subir worker da lane ${target}`,
+        ...(willDrain ? [`Derrubar lane ${previous}`] : []),
+        'Registrar estado do deploy',
+    ];
+    const next = (index) => {
+        log(`\n[${index}/${plan.length}] ${plan[index - 1]}`);
+    };
+    const fail = (message) => {
+        warn(message);
+        return { ok: false, lane: previous ?? target, previousLane: previous, created, message };
+    };
+    /** Desfaz o que este deploy já fez, deixando o cenário de antes. */
+    const restoreUpstreams = () => {
+        if (!previous)
+            return;
+        writeUpstreams(cwd, previous, record);
+        const restored = reloadProxy(cwd, runner);
+        if (!restored.ok)
+            restartProxy(cwd, runner);
+    };
+    const dropTargetLane = () => {
+        const result = laneCompose(cwd, target, ['down', ...(choices.removeOrphans ? ['--remove-orphans'] : [])], runner, true);
+        if (!result.ok) {
+            warn(`  Não foi possível derrubar a lane ${target}: ${result.stderr.trim() || 'falhou'}`);
+        }
+    };
+    // ---- 1. preflight -------------------------------------------------------
+    next(1);
+    const ready = preflight(runner);
+    if (!ready.ok)
+        return fail(ready.message ?? 'Preflight falhou.');
+    // ---- 2. rede + infra ----------------------------------------------------
+    next(2);
+    const network = ensureNetwork(cwd, runner);
+    if (!network.ok)
+        return fail(`Não foi possível criar a rede okcms-net: ${network.stderr.trim()}`);
+    const infra = infraCompose(cwd, ['up', '-d'], runner, true);
+    if (!infra.ok) {
+        return fail(`Infraestrutura não subiu (docker compose -p okcms up -d):\n${infra.stderr.trim()}`);
+    }
+    for (const dataContainer of ['okcms-postgres', 'okcms-redis']) {
+        const healthy = await waitForContainer(runner, dataContainer, isHealthy, {
+            timeoutMs: timeout.dataMs,
+            intervalMs: timeout.intervalMs,
+        });
+        if (!healthy) {
+            return fail(`${dataContainer} não ficou saudável em 3min — veja \`docker logs ${dataContainer}\`.`);
+        }
+    }
+    log(`  ✓ infra pronta (postgres, redis, proxy)`);
+    // ---- 3. pacotes no host -------------------------------------------------
+    next(3);
+    if (opts.installAll) {
+        const installed = runner('bun', ['install'], { cwd, inherit: true, timeoutMs: 600_000 });
+        if (!installed.ok) {
+            return fail(`bun install falhou:\n${installed.stderr.trim()}`);
+        }
+        log('  ✓ dependências instaladas no host');
+    }
+    else if (packages.length > 0) {
+        const installed = installPackages(cwd, packages, runner);
+        if (!installed.ok) {
+            return fail(`Falha ao instalar pacotes no host (${installed.command}):\n${installed.stderr.trim()}`);
+        }
+        log(`  ✓ ${packages.length} pacote(s) atualizado(s) no host`);
+    }
+    else {
+        log('  ✓ nada para instalar (pacotes em dia)');
+    }
+    // ---- 4. build -----------------------------------------------------------
+    next(4);
+    const buildArgs = ['build', ...(choices.noCache ? ['--no-cache'] : [])];
+    const build = laneCompose(cwd, target, buildArgs, runner, true);
+    if (!build.ok) {
+        return fail(`Build da lane ${target} falhou:\n${build.stderr.trim()}`);
+    }
+    log(`  ✓ imagem okcms/app construída${choices.noCache ? ' (sem cache)' : ''}`);
+    // ---- 5. migrations ------------------------------------------------------
+    // No HOST, entre o build e qualquer tráfego: falhou aqui = a lane velha
+    // continua servindo e o banco não foi tocado por um container novo.
+    next(5);
+    const migrate = migrateInvocation();
+    const migrated = runner(migrate.command, migrate.args, { cwd, inherit: true, timeoutMs: 600_000 });
+    if (!migrated.ok) {
+        return fail(`Migrations falharam — nada foi trocado, a lane ${previous ?? '(nenhuma)'} continua servindo.\n` +
+            `${migrated.stderr.trim()}`);
+    }
+    // ---- 6. edge da lane nova ----------------------------------------------
+    next(6);
+    const services = laneServices(cwd, target);
+    const up = laneCompose(cwd, target, ['up', '-d', ...services.edge], runner, true);
+    if (!up.ok) {
+        dropTargetLane();
+        return fail(`Lane ${target} não subiu:\n${up.stderr.trim()}`);
+    }
+    // ---- 7. healthcheck -----------------------------------------------------
+    next(7);
+    const containers = laneContainers(cwd, target);
+    for (const name of containers.edge) {
+        const healthy = await waitForContainer(runner, name, isHealthy, {
+            timeoutMs: timeout.edgeMs,
+            intervalMs: timeout.intervalMs,
+        });
+        if (!healthy) {
+            dropTargetLane();
+            return fail(`${name} não ficou saudável — tráfego NÃO foi movido, ` +
+                `a lane ${previous ?? '(nenhuma)'} continua servindo.`);
+        }
+    }
+    log(`  ✓ ${containers.edge.length} contêiner(es) de edge saudável(is)`);
+    // ---- 8. swap ------------------------------------------------------------
+    next(8);
+    writeUpstreams(cwd, target, record);
+    const reloaded = reloadProxy(cwd, runner);
+    if (!reloaded.ok) {
+        const restarted = restartProxy(cwd, runner);
+        if (!restarted.ok) {
+            restoreUpstreams();
+            dropTargetLane();
+            return fail(`Proxy não recarregou (${reloaded.stderr.trim() || reloaded.command}) — ` +
+                `upstreams restaurados na lane ${previous ?? '(nenhuma)'}.`);
+        }
+        warn('  nginx -s reload falhou; caiu para docker restart (conexões zeradas).');
+    }
+    log(`  ✓ tráfego agora na lane ${target}`);
+    // ---- 9. dreno do worker antigo -----------------------------------------
+    if (willDrain) {
+        next(9);
+        const oldWorkerService = laneServices(cwd, previous).worker[0];
+        const oldWorkerContainer = laneContainers(cwd, previous).worker[0];
+        if (oldWorkerService) {
+            // SIGTERM + stop_grace_period (30s no compose): a fila termina o job em
+            // mãos antes de morrer. `kill` direto abandonaria job em processamento.
+            laneCompose(cwd, previous, ['stop', oldWorkerService], runner, true);
+            if (oldWorkerContainer) {
+                await waitStopped(runner, oldWorkerContainer, {
+                    timeoutMs: timeout.stopMs,
+                    intervalMs: Math.min(1_000, timeout.intervalMs),
+                });
+            }
+            log(`  ✓ worker da lane ${previous} drenado`);
+        }
+    }
+    // ---- 10. worker novo ----------------------------------------------------
+    next(willDrain ? 10 : 9);
+    const workerService = services.worker[0];
+    if (workerService) {
+        const upWorker = laneCompose(cwd, target, ['up', '-d', workerService], runner, true);
+        if (!upWorker.ok) {
+            warn(`  Worker da lane ${target} não subiu: ${upWorker.stderr.trim()}`);
+            warn('  A fila fica sem consumidor até o próximo deploy — edge segue no ar.');
+        }
+        else {
+            log(`  ✓ worker da lane ${target} no ar`);
+        }
+    }
+    // ---- 11. derruba a lane antiga ------------------------------------------
+    if (willDrain) {
+        next(11);
+        // NB: nunca `-v`. Okcms-storage é compartilhado entre blue e green —
+        // derrubar o volume apagaria a mídia no meio do deploy.
+        const downArgs = ['down', ...(choices.removeOrphans ? ['--remove-orphans'] : [])];
+        const down = laneCompose(cwd, previous, downArgs, runner, true);
+        if (!down.ok) {
+            warn(`  Lane ${previous} não derrubou completamente: ${down.stderr.trim()}`);
+            warn('  Rode manualmente: docker compose -p okcms-' + previous + ' down');
+        }
+        else {
+            log(`  ✓ lane ${previous} derrubada${choices.removeOrphans ? ' (órfãos removidos)' : ''}`);
+        }
+    }
+    // ---- 12. estado ---------------------------------------------------------
+    next(plan.length);
+    const state = pushLaneState(readLaneState(cwd), target, record['OKCMS_VERSION'] ?? 'latest');
+    writeLaneState(cwd, state);
+    const healthy = await probe(FINAL_HEALTH_URL);
+    if (!healthy) {
+        warn(`  Aviso: ${FINAL_HEALTH_URL} não respondeu pelo proxy após o swap.\n` +
+            '  Os contêineres estão saudáveis (checagem interna); confira o Host/SERVER_NAME.');
+    }
+    log(`\n  Deploy concluído: lane ${target} no ar${previous ? ` (rollback: ${previous})` : ''}.`);
+    if (created.length > 0) {
+        log(`  Arquivos de deploy criados: ${created.join(', ')}`);
+    }
+    log('  Proxy: http://<host>/  ·  Admin: http://<host>:8080/');
+    return { ok: true, lane: target, previousLane: previous, created };
+}
+//# sourceMappingURL=bluegreen.js.map

package/dist/bluegreen.js.map

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

package/dist/commands.d.ts

@@ -4,6 +4,12 @@ export interface Option {
     description: string;
     required: boolean;
     default?: string;
+    /**
+     * Aceita repetição no comando (`--set A=1 --set B=2`). O parser acumula
+     * múltiplas ocorrências em `KEY` separadas por `\n` — sem isso a segunda
+     * ocorrência sobrescreveria a primeira silenciosamente.
+     */
+    repeatable?: boolean;
 }
 export interface Command {
     name: string;

package/dist/commands.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"commands.d.ts","sourceRoot":"","sources":["../src/commands.ts"],"names":[],"mappings":"AAGA,MAAM,WAAW,MAAM;IACrB,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,EAAE,MAAM,CAAC;IACpB,QAAQ,EAAE,OAAO,CAAC;IAClB,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,OAAO;IACtB,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,OAAO,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;CAC7E;AAwCD,eAAO,MAAM,QAAQ,EAAE,OAAO,EA6yB7B,CAAC;AAEF,wBAAgB,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,GAAG,SAAS,CAE5D"}
+{"version":3,"file":"commands.d.ts","sourceRoot":"","sources":["../src/commands.ts"],"names":[],"mappings":"AAIA,MAAM,WAAW,MAAM;IACrB,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,EAAE,MAAM,CAAC;IACpB,QAAQ,EAAE,OAAO,CAAC;IAClB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB;;;;OAIG;IACH,UAAU,CAAC,EAAE,OAAO,CAAC;CACtB;AAED,MAAM,WAAW,OAAO;IACtB,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,OAAO,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;CAC7E;AAwCD,eAAO,MAAM,QAAQ,EAAE,OAAO,EAk2B7B,CAAC;AAEF,wBAAgB,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,GAAG,SAAS,CAE5D"}