@orkastery/cli 0.6.1 → 0.6.3

package/dist/{canarios-i43.js → cenarios-i43.js}

@@ -1,13 +1,13 @@
 "use strict";
 /**
- * Canarios da I-43: cada remocao so e dada como pronta junto do canario que prova que
+ * Cenarios da I-43: cada remocao so e dada como pronta junto do cenario que prova que
  * a falha evitada pelo mecanismo removido continua evitada por outra coisa.
  *
- * Remocao sem canario nao e simplificacao, e aposta. E a razao de este arquivo existir
+ * Remocao sem cenario nao e simplificacao, e aposta. E a razao de este arquivo existir
  * separado: o CHECK confere as cinco remocoes num lugar so, e o que cada uma perdeu
  * esta escrito ao lado do que a substitui.
  *
- * Os canarios rodam em sandbox git propria (`sandboxGit`), nunca contra o board vivo:
+ * Os cenarios rodam em sandbox git propria (`sandboxGit`), nunca contra o board vivo:
  * `raizDoEstado` manda o estado para a arvore principal mesmo de dentro de uma worktree
  * vinculada, entao qualquer conferencia feita "no projeto" leria as 137 threads reais
  * e viraria contagem de artefato vivo, que reprova sozinha quando a branch cresce.
@@ -46,7 +46,7 @@ var __importStar = (this && this.__importStar) || (function () {
     };
 })();
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.CANARIOS_I43 = void 0;
+exports.CENARIOS_I43 = void 0;
 const sandbox_1 = require("./sandbox");
 const fs = __importStar(require("node:fs"));
 const hosts_1 = require("./hosts");
@@ -82,7 +82,7 @@ function pedidoLegado(modo) {
  * `modo: look, profundidade: profunda` deixaria de validar EM SILENCIO: o produto
  * passaria a negar o que ele mesmo emitiu e assinou.
  *
- * O canario grava uma thread em modo aposentado direto no disco da sandbox, como uma
+ * O cenario grava uma thread em modo aposentado direto no disco da sandbox, como uma
  * thread de setembro esta gravada, e cobra que ela abra inteira.
  */
 const fxModoAposentadoLeitor = {
@@ -139,7 +139,7 @@ const fxModoAposentadoLeitor = {
  * resultado desta aposentadoria: o builder escreve `#Look` no pedido e recebe uma
  * thread em `#Auto` sem saber que trocou de regime de supervisao.
  *
- * O canario cobra as tres coisas juntas: a recusa acontece, ela e TIPADA, e ela nomeia
+ * O cenario cobra as tres coisas juntas: a recusa acontece, ela e TIPADA, e ela nomeia
  * um substituto que EXISTE. Toda #TAG do texto e um modo da matriz, e o substituto e
  * sempre de ciclo completo: com a I-42, o `#Fast` existe, mas nao substitui modo de
  * vigilancia maxima.
@@ -207,12 +207,12 @@ const fxModoAposentadoEscritor = {
  * `Sessao adotada claude-bg <uuid>`, lixo do mecanismo de adocao de 07 a 14/09. Quem
  * pagava era quem nao sabia que existia flag, porque flag nenhuma existia.
  *
- * O canario roda em SANDBOX e nunca contra o board vivo, e isso nao e detalhe: M8 do
+ * O cenario roda em SANDBOX e nunca contra o board vivo, e isso nao e detalhe: M8 do
  * PLAN mediu que `ork thread list` rodado DENTRO desta worktree lista as 137 threads
  * da arvore principal, porque `raizDoEstado` resolve o estado pelo `git-common-dir`.
  * Conferir "no projeto" seria comparar 137 com 10 e afirmar contagem de artefato vivo,
  * que reprova sozinha quando a branch cresce. Aqui as contagens sao 1 e 2, fixadas
- * pelo proprio canario.
+ * pelo proprio cenario.
  *
  * A thread PAUSADA e a razao de o default ser "nao fechadas" e nao "so abertas", que
  * era o texto do GOAL: esconder a pausada seria esconder a que mais pede atencao.
@@ -246,7 +246,7 @@ const fxListagemAbertas = {
                 comTodas: todas.length,
                 todasTemAFechada: todas.some((l) => l.id === fechada.id),
                 // A soma bate: default + fechadas = tudo. Sem afirmar numero de artefato vivo,
-                // porque as tres threads sao criadas por este canario.
+                // porque as tres threads sao criadas por este cenario.
                 somaBate: padrao.length + todas.filter((l) => l.status === 'fechada').length === todas.length,
                 // E o texto avisa que escondeu algo, em vez de esconder em silencio.
                 avisaQueEscondeu: texto.includes('fechada(s) omitida(s)'),
@@ -261,7 +261,7 @@ const fxListagemAbertas = {
  * fx-indice-reversao: a entrega revertida se rebaixa SOZINHA, pelo caminho que o
  * produto percorre de verdade.
  *
- * E o canario que libera a saida da fila de ratificacao de score, e ele prova a
+ * E o cenario que libera a saida da fila de ratificacao de score, e ele prova a
  * propriedade exata que a fila nao entregava: a fila tinha 13 entradas esperando nota
  * humana justamente porque lembrete nao converte em nota, e nenhuma delas dizia se a
  * entrega tinha sido desfeita depois.
@@ -269,7 +269,7 @@ const fxListagemAbertas = {
  * ELE NAO CHAMA A DETECCAO A MAO, e essa e a mudanca do GO-FIX 1. Na primeira versao
  * ele chamava `registrarReversaoDaEntrega` direto, que era justamente o passo que no
  * produto ninguem executava: o unico chamador era o COMECO de um `ork ship` seguinte
- * da mesma thread, e depois do MASTER nao ha ship seguinte. O canario ficava verde com
+ * da mesma thread, e depois do MASTER nao ha ship seguinte. O cenario ficava verde com
  * a propriedade quebrada, e o CHECK provou com `git revert` real que o produto gravava
  * score 5 e a justificativa "sem reversao" numa entrega desfeita.
  *
@@ -360,7 +360,7 @@ const fxIndiceReversao = {
  * de CHECK, e em 11 delas o CHECK rodou apenas em runtime que o GO tambem usou. As
  * quatro threads mais recentes sao todas `claude-bg` conferindo `claude-bg`.
  *
- * O canario prova os TRES lados, porque so o positivo nao provaria nada:
+ * O cenario prova os TRES lados, porque so o positivo nao provaria nada:
  *   - a thread que EXIGE recusa o CHECK no runtime do GO, com motivo tipado;
  *   - a mesma thread ACEITA o CHECK em outro runtime;
  *   - a thread que NAO exige despacha normalmente, entao a regra nao vazou para quem
@@ -421,7 +421,7 @@ const fxCheckRuntimeCruzado = {
  * objective da thread nao esta approved, com teste que cobre a recusa". Bonito, e
  * impossivel de reprovar.
  *
- * O canario prova as duas metades, porque criterio que so passa nao prova nada:
+ * O cenario prova as duas metades, porque criterio que so passa nao prova nada:
  *   - o criterio que o comando SUSTENTA passa e a thread verifica;
  *   - o criterio que o comando NAO sustenta reprova, e o veredito diz QUAL criterio
  *     falhou, pela alegacao que a claim carrega.
@@ -478,7 +478,7 @@ const fxDoneWhenExecutavel = {
  * a copia. Trocar uma recusa barulhenta por nada seria trocar investigacao de
  * madrugada por defeito que ninguem ve.
  *
- * O que muda e o que BARRA, nao o que DETECTA. O canario cobra os dois lados:
+ * O que muda e o que BARRA, nao o que DETECTA. O cenario cobra os dois lados:
  *   - a copia editada e detectada, NOMEADA, e classificada como `copia-editada`;
  *   - a divergencia segura (`catalogo-andou`) resolve sozinha e nao vira decisao;
  *   - a saida traz o `diff` do arquivo e um caminho de UM comando, com o `--dir` em
@@ -492,7 +492,7 @@ const fxAdapterEditadoDetectado = {
     rodar: (ctx) => {
         const destino = (0, sandbox_1.dirTemporario)('adapter-editado');
         try {
-            const comum = { projeto: destino, dir: '.', catalogo: ctx.catalogo, versao: '0.0.0-canario' };
+            const comum = { projeto: destino, dir: '.', catalogo: ctx.catalogo, versao: '0.0.0-cenario' };
             // 1. Instalacao limpa: nasce o recibo com o sha de cada arquivo.
             const primeira = (0, hosts_1.instalarAdaptador)('hermes', comum);
             const recibo = (0, hosts_1.lerRecibo)(destino);
@@ -532,7 +532,7 @@ const fxAdapterEditadoDetectado = {
         }
     },
 };
-exports.CANARIOS_I43 = [
+exports.CENARIOS_I43 = [
     fxModoAposentadoLeitor,
     fxModoAposentadoEscritor,
     fxListagemAbertas,

package/dist/{canarios-pulse.js → cenarios-pulse.js}

@@ -33,7 +33,7 @@ var __importStar = (this && this.__importStar) || (function () {
     };
 })();
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.CANARIOS_PULSE = void 0;
+exports.CENARIOS_PULSE = void 0;
 const fs = __importStar(require("node:fs"));
 const path = __importStar(require("node:path"));
 const node_child_process_1 = require("node:child_process");
@@ -52,7 +52,7 @@ const pulse_1 = require("./pulse");
 const orquestracao_1 = require("./orquestracao");
 const pulse_delivery_1 = require("./pulse-delivery");
 const catalogo_1 = require("./catalogo");
-exports.CANARIOS_PULSE = [
+exports.CENARIOS_PULSE = [
     { id: 'fx-estado-dividido', sobre: '90 eventos na worktree não podem parecer 14 na main', precisaDeGit: true, rodar: () => {
             const s = (0, sandbox_1.sandboxGit)('estado-dividido');
             try {
@@ -116,7 +116,7 @@ exports.CANARIOS_PULSE = [
                 const t = (0, thread_1.novaThread)(s.carregado, { nome: 'resposta simulada', modo: 'classic' }).thread;
                 (0, ledger_1.registrar)((0, thread_1.dirThread)(s.dir, t.id), t.id, 'phase_result', { fase: 'GOAL', evidencia: 'SIMULADO' });
                 const pedido = (0, hitl_gates_1.abrirPedidoGate)(s.dir, t.id);
-                const chave = 'canario-SIMULADO-sem-credencial-real-000';
+                const chave = 'cenario-SIMULADO-sem-credencial-real-000';
                 const resposta = { origem: 'telegram', por: 'telegram:42', mensagem: 'telegram:-7:99',
                     resposta: '1', recebidoEm: new Date().toISOString() };
                 const envelope = { ...resposta, prova: (0, hitl_gates_1.assinaturaDaResposta)(t.id, pedido.id, resposta, chave) };

package/dist/{canarios-rm057.js → cenarios-rm057.js}

@@ -35,11 +35,11 @@ var __importStar = (this && this.__importStar) || (function () {
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.fxPedidoColado = exports.PROMPTS_DE_CONDUCAO = exports.FRASE_DO_PEDIDO_COLADO = exports.PEDIDO_COLADO_DO_INCIDENTE = void 0;
 /**
- * RM-057 (fatia 2): o canario do incidente de 01/10/2026.
+ * RM-057 (fatia 2): o cenario do incidente de 01/10/2026.
  *
  * Na noite de 01 para 02/10 o condutor recebeu, colado, o pedido do dono com push e merge
  * autorizados ate um horario, parou para pedir um "confirmo" em texto livre e a fabrica ficou mais
- * de 10 h sem produzir. O canario refaz a conducao inteira em sandbox SIMULADO e exige que o mesmo
+ * de 10 h sem produzir. O cenario refaz a conducao inteira em sandbox SIMULADO e exige que o mesmo
  * pedido colado siga sem parar:
  *
  *   1. o modo sai da #TAG do texto colado (`#Auto`), pelo nucleo;
@@ -97,7 +97,7 @@ exports.fxPedidoColado = {
             const decisao = (0, decisao_autonoma_1.registrarDecisao)(s.dir, t.id, {
                 decidido: 'Seguir com push e merge dentro da autorização colada', porque: 'o dono autorizou até 02/10 às 12h',
                 comoMudar: 'reverter o merge', custoDeReverter: { agora: 'um revert', depois: 'um revert' },
-                criterio: { tipo: 'ledger', referencia: `${t.id}#evento:1` }, quemDecidiu: 'canario-SIMULADO', evidencia: 'pedido colado',
+                criterio: { tipo: 'ledger', referencia: `${t.id}#evento:1` }, quemDecidiu: 'cenario-SIMULADO', evidencia: 'pedido colado',
             });
             const confirmo = {
                 contrato: hitl_contract_1.CONTRATO_HITL_V2, id: 'confirmo-SIMULADO', thread: t.id, fase: t.faseAtual, modo: t.modo,

package/dist/{canarios-sensores.js → cenarios-sensores.js}

@@ -33,7 +33,7 @@ var __importStar = (this && this.__importStar) || (function () {
     };
 })();
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.CANARIO_SENSORES = void 0;
+exports.CENARIO_SENSORES = void 0;
 /** T8: subprocessos, CLI e estado canônico reais; protocolo Codex sintético. */
 const fs = __importStar(require("node:fs"));
 const path = __importStar(require("node:path"));
@@ -50,11 +50,11 @@ function esperar(teste) {
     const limite = Date.now() + 5000;
     while (!teste()) {
         if (Date.now() >= limite)
-            throw new Error('subprocesso do canário não terminou em 5000 ms');
+            throw new Error('subprocesso do cenário não terminou em 5000 ms');
         Atomics.wait(new Int32Array(new SharedArrayBuffer(4)), 0, 0, 10);
     }
 }
-exports.CANARIO_SENSORES = {
+exports.CENARIO_SENSORES = {
     id: 'fx-sensores-runtime', sobre: 'hooks, supervisor e watcher integrados em sandbox Git', precisaDeGit: true,
     rodar: ({ catalogo }) => {
         const s = (0, sandbox_1.sandboxGit)('sensores-runtime');
@@ -75,7 +75,7 @@ exports.CANARIO_SENSORES = {
                 input: JSON.stringify({ cwd: wt, session_id: 'fixture-claude', hook_event_name: 'PermissionRequest', tool_use_id: 'fixture-tool' }),
                 env: { ...process.env, ORK_SENSOR_CLI: cli } });
             if (h.status !== 0 || h.stderr || h.stdout)
-                throw new Error('hook/CLI do canário indisponível');
+                throw new Error('hook/CLI do cenário indisponível');
             const hookLatenciaMs = Date.now() - start;
             const bloqueio = (0, ledger_1.lerLedger)(dir).find(e => e.tipo === 'sessao_bloqueada');
             const carimboLatenciaMs = bloqueio ? Date.parse(String(bloqueio.recebidoEm)) - Date.parse(bloqueio.ts) : null;
@@ -100,7 +100,7 @@ exports.CANARIO_SENSORES = {
             const runner = require.resolve('./adapters/codex-runner');
             const morto = (0, node_child_process_1.spawnSync)(process.execPath, ['-e', `console.log(JSON.stringify(require(process.argv[1]).identidadeProcesso(process.pid)))`, runner], { cwd: wt, encoding: 'utf8', timeout: 5000 });
             if (morto.status !== 0)
-                throw new Error('processo de morte do canário indisponível');
+                throw new Error('processo de morte do cenário indisponível');
             const filho = JSON.parse(morto.stdout);
             if ((0, codex_runner_1.estadoProcesso)(filho) !== 'ausente')
                 throw new Error('processo ainda não está ausente');

package/dist/{canarios.js → cenarios.js}

@@ -1,8 +1,8 @@
 "use strict";
 /**
- * Os 7 canarios de `ork eval` (6 do bloco B4 + fx-codex-dry da homologacao do codex).
+ * Os 7 cenarios de `ork eval` (6 do bloco B4 + fx-codex-dry da homologacao do codex).
  *
- * Canario nao e teste unitario: e um comportamento inteiro do produto, exercitado ponta a
+ * Cenario nao e teste unitario: e um comportamento inteiro do produto, exercitado ponta a
  * ponta contra git de verdade, que precisa continuar acontecendo depois de qualquer mudanca.
  * Cada um nasce de um jeito conhecido de o trabalho de um agente parecer certo e nao ser:
  *
@@ -51,8 +51,8 @@ var __importStar = (this && this.__importStar) || (function () {
     };
 })();
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.gitDisponivel = exports.CANARIOS = void 0;
-exports.canarioPorId = canarioPorId;
+exports.gitDisponivel = exports.CENARIOS = void 0;
+exports.cenarioPorId = cenarioPorId;
 const node_child_process_1 = require("node:child_process");
 const fs = __importStar(require("node:fs"));
 const path = __importStar(require("node:path"));
@@ -67,11 +67,11 @@ Object.defineProperty(exports, "gitDisponivel", { enumerable: true, get: functio
 const thread_1 = require("./thread");
 const verify_1 = require("./verify");
 const worktree_1 = require("./worktree");
-const canarios_pulse_1 = require("./canarios-pulse");
-const canarios_sensores_1 = require("./canarios-sensores");
-const canarios_hitl_1 = require("./canarios-hitl");
-const canarios_i43_1 = require("./canarios-i43");
-const canarios_rm057_1 = require("./canarios-rm057");
+const cenarios_pulse_1 = require("./cenarios-pulse");
+const cenarios_sensores_1 = require("./cenarios-sensores");
+const cenarios_hitl_1 = require("./cenarios-hitl");
+const cenarios_i43_1 = require("./cenarios-i43");
+const cenarios_rm057_1 = require("./cenarios-rm057");
 const objective_1 = require("./objective");
 const maestro_discovery_1 = require("./maestro-discovery");
 const maestro_cli_1 = require("./maestro-cli");
@@ -196,7 +196,7 @@ const fxWikiDestroy = {
                 };
             }
         };
-        // A outra metade do canario: a policy bloqueante do nucleo, que reprova entregar em cima
+        // A outra metade do cenario: a policy bloqueante do nucleo, que reprova entregar em cima
         // da propria base. Guard do host e policy do nucleo sao defesas independentes de proposito.
         const manifesto = {
             runtime: { provider_policy: 'subscription-only' },
@@ -273,7 +273,7 @@ const fxConcurrency = {
  * Nasce da homologacao do segundo runtime (thread ork-homologarcod): um `setup.json`
  * apontando o bloco para o codex tem de mudar o COMANDO que o despacho monta, e o
  * default sem setup tem de continuar saindo pelo claude-bg byte a byte (paridade sem
- * downgrade). Tudo em dry-run: canario nao gasta assinatura de ninguem.
+ * downgrade). Tudo em dry-run: cenario nao gasta assinatura de ninguem.
  */
 const fxCodexDry = {
     id: 'fx-codex-dry',
@@ -335,7 +335,7 @@ const fxMaestroBootstrap = {
         const exit = (0, maestro_cli_1.runMaestroCli)(['--json'], s.dir, {}, { out: v => { raw = v; }, err: () => { } });
         const clean = JSON.parse(raw);
         const createsThread = (0, thread_1.listarIds)(s.dir).length !== before;
-        const t = (0, thread_1.novaThread)(s.carregado, { nome: 'Canário Maestro', modo: 'auto' }).thread;
+        const t = (0, thread_1.novaThread)(s.carregado, { nome: 'Cenário Maestro', modo: 'auto' }).thread;
         const context = (0, maestro_discovery_1.discoverMaestro)({ cwd: s.dir });
         const snapshot = () => (0, maestro_cli_1.readMaestro)(context, { host: { tools: ['ork_thread_status', 'ork_phase_run'], child: true } });
         const state = snapshot();
@@ -359,8 +359,8 @@ const fxMaestroBootstrap = {
         };
     }),
 };
-/** Os canarios registrados, na ordem em que o `ork eval` os roda. */
-exports.CANARIOS = [
+/** Os cenarios registrados, na ordem em que o `ork eval` os roda. */
+exports.CENARIOS = [
     fxHappy,
     fxHallucination,
     fxStaleBase,
@@ -370,13 +370,13 @@ exports.CANARIOS = [
     fxCodexDry,
     fxObjectiveOscillation,
     fxMaestroBootstrap,
-    ...canarios_pulse_1.CANARIOS_PULSE,
-    canarios_sensores_1.CANARIO_SENSORES,
-    ...canarios_hitl_1.CANARIOS_HITL,
-    ...canarios_i43_1.CANARIOS_I43,
-    canarios_rm057_1.fxPedidoColado,
+    ...cenarios_pulse_1.CENARIOS_PULSE,
+    cenarios_sensores_1.CENARIO_SENSORES,
+    ...cenarios_hitl_1.CENARIOS_HITL,
+    ...cenarios_i43_1.CENARIOS_I43,
+    cenarios_rm057_1.fxPedidoColado,
 ];
-/** Um canario por id, ou null quando a fixture aponta para um canario que nao existe. */
-function canarioPorId(id) {
-    return exports.CANARIOS.find((c) => c.id === id) ?? null;
+/** Um cenario por id, ou null quando a fixture aponta para um cenario que nao existe. */
+function cenarioPorId(id) {
+    return exports.CENARIOS.find((c) => c.id === id) ?? null;
 }

package/dist/changelog-check.js

@@ -0,0 +1,217 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.GRUPOS_NAO_PUBLICADOS = exports.SECAO_NAO_PUBLICADO = exports.CHANGELOG = void 0;
+exports.ehTeste = ehTeste;
+exports.pedeLinha = pedeLinha;
+exports.linhasDaSecao = linhasDaSecao;
+exports.versoes = versoes;
+exports.changelogAplicavel = changelogAplicavel;
+exports.checarChangelog = checarChangelog;
+exports.basePadrao = basePadrao;
+/**
+ * RM-037: regra unica do CHANGELOG para o script do CI, `docs verificar --pr` e `ork verify`.
+ * O diff decide quais linhas a thread acrescentou; o texto do HEAD decide em que secao e grupo
+ * cada linha caiu; uma tag local `v<versao>` prova que a secao ja foi publicada.
+ */
+const node_child_process_1 = require("node:child_process");
+exports.CHANGELOG = 'CHANGELOG.md';
+exports.SECAO_NAO_PUBLICADO = 'Não publicado';
+exports.GRUPOS_NAO_PUBLICADOS = ['Adicionado', 'Alterado', 'Corrigido', 'Segurança'];
+const PASTAS_DE_PRODUTO = ['core/', 'adapters/', 'marketplaces/'];
+const DE_CI = [/^\.github\//, /^\.ork-ci\//, /^core\/scripts\/test-ci\.js$/, /^core\/scripts\/checar-[a-z0-9-]+\.cjs$/];
+const CORRECAO = 'acrescente em "## Não publicado" do CHANGELOG.md uma linha que diga o que muda para quem usa, ' +
+    'sob "### Adicionado", "### Alterado", "### Corrigido" ou "### Segurança" ' +
+    '(PR só de testes ou só de CI fica de fora: docs/guias/contribuir/pull-request.md)';
+function git(raiz, args) {
+    const r = (0, node_child_process_1.spawnSync)('git', args, { cwd: raiz, encoding: 'utf8', maxBuffer: 64 * 1024 * 1024 });
+    return { ok: r.status === 0, saida: r.stdout ?? '' };
+}
+/** Arquivo de teste: pasta `test`, `tests` ou `__tests__`, ou nome `*.test.*`/`*.spec.*`. */
+function ehTeste(arquivo) {
+    const partes = arquivo.split('/');
+    return partes.slice(0, -1).some((p) => p === 'test' || p === 'tests' || p === '__tests__')
+        || /\.(test|spec)\.[A-Za-z0-9]+$/.test(partes[partes.length - 1]);
+}
+/** Arquivo de produto que exige uma entrada no CHANGELOG. */
+function pedeLinha(arquivo) {
+    return PASTAS_DE_PRODUTO.some((p) => arquivo.startsWith(p)) && !ehTeste(arquivo) && !DE_CI.some((re) => re.test(arquivo));
+}
+/** Linhas de texto de `## Não publicado`, mantida para consumidores e testes legados. */
+function linhasDaSecao(texto) {
+    const linhas = texto.replace(/\r\n/g, '\n').split('\n');
+    const inicio = linhas.findIndex((linha) => linha.trim() === `## ${exports.SECAO_NAO_PUBLICADO}`);
+    if (inicio < 0)
+        return null;
+    const corpo = [];
+    for (const linha of linhas.slice(inicio + 1)) {
+        if (/^## /.test(linha))
+            break;
+        if (linha.trim() && !/^#/.test(linha.trim()))
+            corpo.push(linha.trimEnd());
+    }
+    return corpo;
+}
+/** Versoes nos dois formatos historicos do arquivo. */
+function versoes(texto) {
+    return new Set([...texto.replace(/\r\n/g, '\n').matchAll(/^## \[?(\d+\.\d+\.\d+[0-9A-Za-z.+-]*)\]?(?=\s|$)/gm)]
+        .map((m) => m[1]));
+}
+function changelogEm(raiz, ref) {
+    const r = git(raiz, ['show', `${ref}:${exports.CHANGELOG}`]);
+    return r.ok ? r.saida : '';
+}
+/**
+ * A regra protege um histórico publicado. Repositórios ainda sem versão `v*` ou sem
+ * CHANGELOG no HEAD não têm esse contrato para comparar e ficam fora do verificador.
+ */
+function changelogAplicavel(raiz, head = 'HEAD') {
+    const arquivo = git(raiz, ['cat-file', '-e', `${head}:${exports.CHANGELOG}`]);
+    if (!arquivo.ok)
+        return false;
+    const tags = git(raiz, ['tag', '--merged', head, '--list', 'v*']);
+    return tags.ok && tags.saida.split('\n').some((tag) => tag.trim().length > 1);
+}
+/** Linhas acrescentadas no arquivo, com o numero que ocupam no HEAD. */
+function linhasAcrescentadas(raiz, base, head) {
+    const d = git(raiz, ['diff', '--no-color', '--unified=0', '--no-renames', base, head, '--', exports.CHANGELOG]);
+    if (!d.ok)
+        return [];
+    const novas = [];
+    let numero = 0, emTrecho = false;
+    for (const linha of d.saida.replace(/\r\n/g, '\n').split('\n')) {
+        const hunk = /^@@ -\d+(?:,\d+)? \+(\d+)(?:,\d+)? @@/.exec(linha);
+        if (hunk) {
+            numero = Number(hunk[1]);
+            emTrecho = true;
+            continue;
+        }
+        if (!emTrecho || linha.startsWith('\\ No newline'))
+            continue;
+        if (linha.startsWith('+')) {
+            novas.push({ numero, texto: linha.slice(1) });
+            numero++;
+        }
+        else if (!linha.startsWith('-'))
+            numero++;
+    }
+    return novas;
+}
+function contextos(texto) {
+    const porLinha = [{ secao: null, grupo: null, versao: null }];
+    let secao = null, grupo = null, versao = null;
+    for (const linha of texto.replace(/\r\n/g, '\n').split('\n')) {
+        const h2 = /^## (.+?)\s*$/.exec(linha);
+        if (h2) {
+            secao = h2[1];
+            grupo = null;
+            versao = /^\[?(\d+\.\d+\.\d+[0-9A-Za-z.+-]*)\]?(?:\s|$)/.exec(secao)?.[1] ?? null;
+        }
+        else {
+            const h3 = /^### (.+?)\s*$/.exec(linha);
+            if (h3)
+                grupo = h3[1];
+        }
+        porLinha.push({ secao, grupo, versao });
+    }
+    return porLinha;
+}
+function tagPublicada(raiz, versao) {
+    return git(raiz, ['rev-parse', '--verify', '--quiet', `refs/tags/v${versao}^{commit}`]).ok;
+}
+/**
+ * Confere o diff da thread ate `head`.
+ *
+ * A referencia local da branch alvo pode estar atrasada em relacao ao commit que abriu a
+ * worktree. Quando a base carimbada tambem e ancestral do HEAD e vem depois da merge-base,
+ * ela delimita o que a thread de fato acrescentou. Se a branch alvo avancou para alem dela,
+ * a merge-base mais nova continua vencendo.
+ */
+function checarChangelog(raiz, opcoes = {}) {
+    const head = opcoes.head ?? 'HEAD', base = opcoes.base;
+    const indisponivel = (detalhe) => ({ ok: false, motivo: 'changelog.base-indisponivel', detalhe,
+        correcao: 'rode com o histórico completo do git (fetch-depth: 0 no CI) ou passe --base <ref>', arquivos: [], linhas: [] });
+    if (!git(raiz, ['rev-parse', '--verify', '--quiet', `${head}^{commit}`]).ok)
+        return indisponivel(`o head ${head} não existe neste repositório`);
+    if (!changelogAplicavel(raiz, head)) {
+        const temArquivo = git(raiz, ['cat-file', '-e', `${head}:${exports.CHANGELOG}`]).ok;
+        return { ok: true, motivo: null, arquivos: [], linhas: [], detalhe: temArquivo
+                ? 'regra do CHANGELOG não aplicável: o repositório ainda não tem versão publicada em tag v*'
+                : `regra do CHANGELOG não aplicável: ${exports.CHANGELOG} não existe em ${head}` };
+    }
+    if (!base)
+        return indisponivel('nenhuma base para comparar');
+    if (!git(raiz, ['rev-parse', '--verify', '--quiet', `${base}^{commit}`]).ok)
+        return indisponivel(`a base ${base} não existe neste repositório`);
+    const mb = git(raiz, ['merge-base', base, head]);
+    let ancestral = mb.saida.trim();
+    if (!mb.ok || !ancestral)
+        return indisponivel(`${base} e ${head} não têm ancestral comum`);
+    const carimbada = opcoes.baseCarimbada?.trim();
+    if (carimbada
+        && git(raiz, ['rev-parse', '--verify', '--quiet', `${carimbada}^{commit}`]).ok
+        && git(raiz, ['merge-base', '--is-ancestor', carimbada, head]).ok
+        && git(raiz, ['merge-base', '--is-ancestor', ancestral, carimbada]).ok) {
+        ancestral = carimbada;
+    }
+    const mudados = git(raiz, ['diff', '--name-only', '--no-renames', '-z', ancestral, head]);
+    const arquivos = (mudados.ok ? mudados.saida.split('\0') : []).filter(Boolean);
+    const pedem = arquivos.filter(pedeLinha);
+    const antes = changelogEm(raiz, ancestral), depois = changelogEm(raiz, head);
+    const novas = linhasAcrescentadas(raiz, ancestral, head);
+    const porLinha = contextos(depois);
+    // D4: uma entrada correta em Nao publicado nunca esconde uma edicao retrospectiva.
+    for (const linha of novas) {
+        if (!linha.texto.trim())
+            continue;
+        const contexto = porLinha[linha.numero] ?? { secao: null, grupo: null, versao: null };
+        if (contexto.versao && tagPublicada(raiz, contexto.versao)) {
+            return { ok: false, motivo: 'changelog.secao-publicada', arquivos: pedem, linhas: [linha.texto], secao: contexto.secao ?? undefined,
+                detalhe: `a linha nova ${linha.numero} caiu em "## ${contexto.secao}", versão já publicada pela tag v${contexto.versao}`,
+                correcao: `mova a linha para "## ${exports.SECAO_NAO_PUBLICADO}", sob um dos grupos permitidos` };
+        }
+    }
+    const entradasNaoPublicadas = novas.filter((linha) => {
+        const t = linha.texto.trim(), contexto = porLinha[linha.numero];
+        return !!t && !/^#{2,3} /.test(t) && contexto?.secao === exports.SECAO_NAO_PUBLICADO;
+    });
+    for (const linha of entradasNaoPublicadas) {
+        const grupo = porLinha[linha.numero]?.grupo ?? null;
+        if (!grupo)
+            return { ok: false, motivo: 'changelog.grupo-ausente', arquivos: pedem, linhas: [linha.texto], grupo,
+                detalhe: `a linha nova ${linha.numero} de "## ${exports.SECAO_NAO_PUBLICADO}" não está sob um título ###`,
+                correcao: `ponha a linha sob ${exports.GRUPOS_NAO_PUBLICADOS.map((g) => `"### ${g}"`).join(', ')}` };
+        if (!exports.GRUPOS_NAO_PUBLICADOS.includes(grupo)) {
+            return { ok: false, motivo: 'changelog.grupo-invalido', arquivos: pedem, linhas: [linha.texto], grupo,
+                detalhe: `a linha nova ${linha.numero} está sob "### ${grupo}", grupo que não vale em "## ${exports.SECAO_NAO_PUBLICADO}"`,
+                correcao: `use ${exports.GRUPOS_NAO_PUBLICADOS.map((g) => `"### ${g}"`).join(', ')}` };
+        }
+    }
+    if (pedem.length === 0)
+        return { ok: true, motivo: null, arquivos: [], linhas: [],
+            detalhe: arquivos.length === 0 ? `nada a conferir: ${head} não muda nada desde ${base}`
+                : 'nada pede linha: o PR não muda core/, adapters/ nem marketplaces/ fora de teste e de CI' };
+    const versaoNova = [...versoes(depois)].filter((v) => !versoes(antes).has(v));
+    if (versaoNova.length > 0)
+        return { ok: true, motivo: null, arquivos: pedem, linhas: [],
+            detalhe: `versão nova no ${exports.CHANGELOG}: ${versaoNova.join(', ')} (o PR de versão leva as linhas para ela)` };
+    if (linhasDaSecao(depois) === null)
+        return { ok: false, motivo: 'changelog.secao-ausente', arquivos: pedem, linhas: [],
+            detalhe: `o ${exports.CHANGELOG} de ${head} não tem a seção "## ${exports.SECAO_NAO_PUBLICADO}"`,
+            correcao: `abra a seção "## ${exports.SECAO_NAO_PUBLICADO}" no alto do ${exports.CHANGELOG} e acrescente a linha da mudança` };
+    if (entradasNaoPublicadas.length > 0)
+        return { ok: true, motivo: null, arquivos: pedem,
+            linhas: entradasNaoPublicadas.map((linha) => linha.texto),
+            detalhe: `${entradasNaoPublicadas.length} linha(s) nova(s) em "## ${exports.SECAO_NAO_PUBLICADO}" sob grupo permitido` };
+    return { ok: false, motivo: 'changelog.linha-ausente', arquivos: pedem, linhas: [],
+        detalhe: `o PR muda ${pedem.length} arquivo(s) de core/, adapters/ ou marketplaces/ (${pedem.slice(0, 3).join(', ')}${pedem.length > 3 ? ', ...' : ''}) e não acrescenta linha válida em "## ${exports.SECAO_NAO_PUBLICADO}" do ${exports.CHANGELOG}`,
+        correcao: CORRECAO };
+}
+/** Base padrao do CI: alvo do PR, main remota, main local. */
+function basePadrao(raiz, env = process.env) {
+    if (env.GITHUB_BASE_REF)
+        return `origin/${env.GITHUB_BASE_REF}`;
+    for (const ref of ['origin/main', 'main'])
+        if (git(raiz, ['rev-parse', '--verify', '--quiet', `${ref}^{commit}`]).ok)
+            return ref;
+    return null;
+}