@orkastery/cli 0.6.1 → 0.6.3

package/dist/fila-pesada.js

@@ -34,6 +34,7 @@ var __importStar = (this && this.__importStar) || (function () {
 })();
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.ErroDaFilaPesada = exports.ENV_DONO_DA_FILA = exports.CONTRATO_FILA_PESADA = void 0;
+exports.avaliarVidaDoOcupante = avaliarVidaDoOcupante;
 exports.kernelDisponivel = kernelDisponivel;
 exports.tentarTravaExclusiva = tentarTravaExclusiva;
 exports.dirDaFilaPesada = dirDaFilaPesada;
@@ -66,6 +67,7 @@ const fs = __importStar(require("node:fs"));
 const path = __importStar(require("node:path"));
 const node_crypto_1 = require("node:crypto");
 const node_child_process_1 = require("node:child_process");
+const node_worker_threads_1 = require("node:worker_threads");
 const estado_thread_1 = require("./estado-thread");
 const horario_1 = require("./horario");
 exports.CONTRATO_FILA_PESADA = 'ork.fila-pesada/v1';
@@ -75,11 +77,27 @@ const FLOCK = '/usr/bin/flock';
 const DIR = 'fila-pesada';
 /** Entre uma tentativa e outra. A vez costuma durar minutos; meio segundo não pesa em ninguém. */
 const PAUSA_MS = 500;
+/** A batida e complementar ao flock: atravessa a observacao de um sandbox com outro namespace de PID. */
+const BATIDA_CADA_MS = 1_000;
+const BATIDA_VALE_MS = 5_000;
+function avaliarVidaDoOcupante(e) {
+    if (e.trava === 'ocupada')
+        return { vida: 'vivo', prova: 'trava-kernel' };
+    if (e.trava === 'livre')
+        return { vida: 'morto', prova: 'trava-livre' };
+    if (e.batidaValida)
+        return { vida: 'vivo', prova: 'batida' };
+    if (e.mesmoHost && e.mesmoEspacoPids && e.processo === 'vivo')
+        return { vida: 'vivo', prova: 'processo' };
+    if (e.mesmoHost && e.mesmoEspacoPids && e.processo === 'ausente')
+        return { vida: 'morto', prova: 'processo-ausente' };
+    return { vida: 'desconhecido', prova: 'indeterminada' };
+}
 /** A recusa é resposta, não falha: o CLI a imprime como a da condução, e sai com 3. */
 class ErroDaFilaPesada extends Error {
     recusa;
     constructor(recusa) {
-        super(`fila-pesada.ocupada: ${recusa.texto}`);
+        super(`${recusa.motivo}: ${recusa.texto}`);
         this.name = 'ErroDaFilaPesada';
         this.recusa = recusa;
     }
@@ -88,11 +106,17 @@ exports.ErroDaFilaPesada = ErroDaFilaPesada;
 function kernelDisponivel() {
     return process.platform === 'linux' && fs.existsSync(FLOCK);
 }
-/** O `flock` exclusivo sem espera sobre um descritor já aberto. O helper tranca a descrição de arquivo, que fica do processo. */
-function trancar(fd) {
+/** Diferencia a contencao provada do erro de observacao; erro nunca vira trava livre. */
+function observarTrava(fd) {
     const r = (0, node_child_process_1.spawnSync)(FLOCK, ['--exclusive', '--nonblock', '3'], { stdio: ['ignore', 'ignore', 'ignore', fd], timeout: 5000 });
-    return r.status === 0 && !r.error;
+    if (!r.error && r.status === 0)
+        return 'adquirida';
+    if (!r.error && r.status === 1)
+        return 'ocupada';
+    return 'desconhecida';
 }
+/** Tomar a trava exige prova positiva. Contencao e observacao inconclusiva falham fechadas. */
+function trancar(fd) { return observarTrava(fd) === 'adquirida'; }
 function abrirTrava(arquivo, criar) {
     const fd = fs.openSync(arquivo, fs.constants.O_RDWR | fs.constants.O_NOFOLLOW | (criar ? fs.constants.O_CREAT : 0), 0o600);
     const st = fs.fstatSync(fd);
@@ -210,11 +234,57 @@ function minhaVez(dir, senha) {
     }
     return true;
 }
+function hashLocal(valor) { return (0, node_crypto_1.createHash)('sha256').update(valor).digest('hex').slice(0, 24); }
+/** Identidades opacas: provam igualdade sem publicar hostname, boot id ou inode do namespace. */
+function identidadeDaMaquina() {
+    let host = null, espacoPids = null;
+    try {
+        host = hashLocal(fs.readFileSync('/proc/sys/kernel/random/boot_id', 'utf8').trim());
+    }
+    catch { /* nao observavel */ }
+    try {
+        espacoPids = hashLocal(fs.readlinkSync('/proc/self/ns/pid'));
+    }
+    catch { /* nao observavel */ }
+    return { host, espacoPids };
+}
 function gravarDono(fd, dono, posse) {
     const bytes = Buffer.from(JSON.stringify({ contrato: exports.CONTRATO_FILA_PESADA, ...dono, posse }) + '\n', 'utf8');
     fs.ftruncateSync(fd, 0);
     fs.writeSync(fd, bytes, 0, bytes.length, 0);
 }
+function arquivoDaBatida(dir, slot, posse) {
+    return path.join(dir, `vaga-${slot}.${posse}.heartbeat.json`);
+}
+/** Worker nativo: a batida continua enquanto o verify sincrono bloqueia a thread JS, sem processo shell perdido. */
+function iniciarBatida(dir, slot, posse) {
+    const arquivo = arquivoDaBatida(dir, slot, posse);
+    try {
+        const worker = new node_worker_threads_1.Worker(`
+      const fs = require('node:fs');
+      const { parentPort, workerData } = require('node:worker_threads');
+      const { randomUUID } = require('node:crypto');
+      let ativo = true;
+      parentPort.on('message', () => { ativo = false; });
+      function bater() {
+        if (!ativo) return;
+        const tmp = workerData.arquivo + '.' + randomUUID() + '.tmp';
+        try {
+          fs.writeFileSync(tmp, JSON.stringify({ contrato: 'ork.fila-pesada-heartbeat/v1', posse: workerData.posse,
+            expiraEm: new Date(Date.now() + workerData.validadeMs).toISOString() }) + '\\n', { flag: 'wx', mode: 0o600 });
+          fs.renameSync(tmp, workerData.arquivo);
+        } catch (_) { try { fs.unlinkSync(tmp); } catch (_) {} }
+        if (ativo) setTimeout(bater, workerData.intervaloMs);
+      }
+      bater();
+    `, { eval: true, workerData: { arquivo, posse, intervaloMs: BATIDA_CADA_MS, validadeMs: BATIDA_VALE_MS } });
+        worker.unref();
+        return { worker, arquivo };
+    }
+    catch {
+        return null;
+    }
+}
 /** O artefato primeiro, depois a primeira vaga livre; sem vaga, solta o artefato. Nunca espera segurando nada. */
 function tentarVaga(dir, pedido) {
     const fdArtefato = tentarTravaExclusiva(path.join(dir, `artefato-${chaveDoArtefato(pedido.artefato)}.lock`));
@@ -224,17 +294,29 @@ function tentarVaga(dir, pedido) {
         const fdVaga = tentarTravaExclusiva(path.join(dir, `vaga-${slot}.lock`));
         if (fdVaga === null)
             continue;
-        const dono = { slot, operacao: pedido.operacao, thread: pedido.thread, artefato: path.resolve(pedido.artefato),
-            pid: process.pid, desde: new Date().toISOString() };
         const id = (0, node_crypto_1.randomUUID)();
+        const identidade = identidadeDaMaquina();
+        const dono = { slot, operacao: pedido.operacao, thread: pedido.thread, artefato: path.resolve(pedido.artefato),
+            pid: process.pid, desde: new Date().toISOString(), inicio: inicioDoProcesso(process.pid), ...identidade };
         gravarDono(fdVaga, dono, id);
         gravarDono(fdArtefato, dono, id);
-        return { fdArtefato, fdVaga, slot, id };
+        const batida = iniciarBatida(dir, slot, id);
+        return { fdArtefato, fdVaga, slot, id, batida: batida?.worker ?? null, arquivoDaBatida: batida?.arquivo ?? null };
     }
     fs.closeSync(fdArtefato);
     return null;
 }
 function soltar(posse) {
+    try {
+        posse.batida?.postMessage('parar');
+        void posse.batida?.terminate();
+    }
+    catch { /* o processo tambem encerra o worker */ }
+    if (posse.arquivoDaBatida)
+        try {
+            fs.unlinkSync(posse.arquivoDaBatida);
+        }
+        catch { /* batida expira sozinha */ }
     for (const fd of [posse.fdVaga, posse.fdArtefato]) {
         try {
             fs.ftruncateSync(fd, 0);
@@ -264,7 +346,8 @@ function ocupantesDaFilaPesada(raiz) {
             continue;
         }
         try {
-            if (trancar(fd))
+            const trava = observarTrava(fd);
+            if (trava === 'adquirida')
                 continue;
             const slot = Number(/^vaga-(\d+)\.lock$/.exec(nome)[1]);
             let dono = {};
@@ -272,9 +355,31 @@ function ocupantesDaFilaPesada(raiz) {
                 dono = JSON.parse(fs.readFileSync(path.join(dir, nome), 'utf8'));
             }
             catch { /* dono ainda gravando */ }
+            let batidaExpiraEm = null;
+            if (typeof dono.posse === 'string') {
+                try {
+                    const batida = JSON.parse(fs.readFileSync(arquivoDaBatida(dir, slot, dono.posse), 'utf8'));
+                    if (batida.posse === dono.posse && typeof batida.expiraEm === 'string')
+                        batidaExpiraEm = batida.expiraEm;
+                }
+                catch { /* batida ausente, vencida ou ainda sendo publicada */ }
+            }
+            const local = identidadeDaMaquina();
+            const mesmoHost = typeof dono.host === 'string' && local.host === dono.host;
+            const mesmoEspacoPids = typeof dono.espacoPids === 'string' && local.espacoPids === dono.espacoPids;
+            let processo = 'desconhecido';
+            if (mesmoHost && mesmoEspacoPids && typeof dono.pid === 'number' && typeof dono.inicio === 'string') {
+                const atual = inicioDoProcesso(dono.pid);
+                processo = atual === dono.inicio ? 'vivo' : atual === null ? 'ausente' : 'ausente';
+            }
+            const estado = avaliarVidaDoOcupante({ trava: trava === 'ocupada' ? 'ocupada' : 'desconhecida',
+                batidaValida: batidaExpiraEm !== null && Date.parse(batidaExpiraEm) > Date.now(), mesmoHost, mesmoEspacoPids, processo });
             ocupantes.push({ slot, operacao: typeof dono.operacao === 'string' ? dono.operacao : 'desconhecida',
                 thread: typeof dono.thread === 'string' ? dono.thread : null, artefato: typeof dono.artefato === 'string' ? dono.artefato : '',
-                pid: typeof dono.pid === 'number' ? dono.pid : 0, desde: typeof dono.desde === 'string' ? dono.desde : '' });
+                pid: typeof dono.pid === 'number' ? dono.pid : 0, desde: typeof dono.desde === 'string' ? dono.desde : '',
+                inicio: typeof dono.inicio === 'string' ? dono.inicio : null, host: typeof dono.host === 'string' ? dono.host : null,
+                espacoPids: typeof dono.espacoPids === 'string' ? dono.espacoPids : null,
+                posse: typeof dono.posse === 'string' ? dono.posse : undefined, batidaExpiraEm, ...estado });
         }
         finally {
             fs.closeSync(fd);
@@ -283,19 +388,24 @@ function ocupantesDaFilaPesada(raiz) {
     return ocupantes;
 }
 function recusaDaFila(pedido, esperouMs, ocupantes) {
+    const indeterminado = ocupantes.some(o => o.vida === 'desconhecido');
+    const motivo = indeterminado ? 'concurrency.lease-indeterminado' : 'fila-pesada.ocupada';
     const espera = esperouMs < 60000 ? `${Math.round(esperouMs / 1000)} s` : `${Math.round(esperouMs / 60000)} min`;
     const linhas = [
         `Operação pesada não executada: ${pedido.operacao}${pedido.thread ? ` da thread ${pedido.thread}` : ''} esperou ${espera} ` +
             `e a fila de recursos pesados não liberou a vez (até ${pedido.slots} ao mesmo tempo, concurrency.max_parallel_heavy). ` +
             'Verify e build juntos nesta máquina dão regressão falsa.',
         ...(ocupantes.length ? ocupantes.map(o => `  Quem ocupa: ${o.operacao}${o.thread ? ` da thread ${o.thread}` : ''}, ` +
-            `desde ${(0, horario_1.formatarDesde)(o.desde)}, processo ${o.pid}.`) : ['  Quem ocupa: a vez é de outro pedido que chegou antes e ainda espera.']),
+            `desde ${(0, horario_1.formatarDesde)(o.desde)}, processo ${o.pid}${o.vida === 'desconhecido' ? '; vida indeterminada' : ''}.`) :
+            ['  Quem ocupa: a vez é de outro pedido que chegou antes e ainda espera.']),
+        ...(indeterminado ? ['A vida do lease não pôde ser comprovada deste ambiente; “não sei” nunca é órfão. ' +
+                'Espere com --esperar ou devolva à condução com concurrency.lease-indeterminado.'] : []),
         'O que você pode fazer:',
         '  1. Esperar a vez: o dono da vaga segue rodando e, quando ele termina ou morre, a vaga volta sozinha.',
         ...(pedido.comandoDeEsperar ? [`     ${pedido.comandoDeEsperar}`] : []),
         '  2. Desligar a fila só nesta máquina, se ela aguenta: concurrency.max_parallel_heavy no orkastery.yaml (0 desliga).',
     ];
-    return { contrato: 'ork.fila-pesada-recusa/v1', motivo: 'fila-pesada.ocupada', operacao: pedido.operacao, thread: pedido.thread,
+    return { contrato: 'ork.fila-pesada-recusa/v1', motivo, operacao: pedido.operacao, thread: pedido.thread,
         slots: pedido.slots, esperouMs, ocupantes, texto: linhas.join('\n') };
 }
 const pausa = new Int32Array(new SharedArrayBuffer(4));

package/dist/hitl-canais.js

@@ -204,7 +204,7 @@ function recusarIngressoNaoHomologado(ingresso) {
     }
     return ingresso;
 }
-/** Invariantes do registro. O teste chama isto; o produto tambem, no canario. */
+/** Invariantes do registro. O teste chama isto; o produto tambem, no cenario. */
 function conferirRegistro() {
     const canais = canaisHomologados();
     if (canais.length !== hosts_1.ORDEM_DOS_HOSTS.length || canais.length !== 4) {

package/dist/hitl-classificacao.js

@@ -71,6 +71,7 @@ exports.MOTIVOS_DO_ORQUESTRADOR = Object.freeze([
     'verify.failed', 'verify.regression', 'verify.timeout', 'verify.sem-veredito',
     'claims.failed', 'claims.unverifiable', 'ci.failed', 'hitl.formato',
     'lease.busy', 'vaga.stale', 'conducao.em-andamento', 'concurrency.limite',
+    'concurrency.lease-indeterminado', 'conducao.acao-necessaria',
 ]);
 function quemDecide(motivo) {
     return exports.MOTIVOS_DO_ORQUESTRADOR.includes(String(motivo ?? '')) ? 'orquestrador' : 'dono';

package/dist/hitl-presentation.js

@@ -178,7 +178,7 @@ function pedidoHitlAberto(raiz, id, fase, sessionId) {
 /**
  * FX6: a oferta de canais que acompanha um pedido HITL REAL.
  *
- * `ofertaDeCanais` existia desde D12 e era chamada de um lugar so: o canario. No caminho de
+ * `ofertaDeCanais` existia desde D12 e era chamada de um lugar so: o cenario. No caminho de
  * producao o humano via a pergunta e um `comandoResposta`, e nada dizia por quais canais dava
  * para responder AGORA nem por que os outros nao serviam. Uma oferta que so aparece em
  * simulacao nao e oferta; e uma tabela bonita, como a propria narrativa de D12 admitia.

package/dist/hitl-tempo-parado.js

@@ -29,7 +29,7 @@ exports.linhaDoHitlAcimaDaMeta = linhaDoHitlAcimaDaMeta;
  *   aberto              nada disso ainda: a espera corre ate o fim do periodo.
  *
  * Limite dito: o "confirmo" que um condutor pede na conversa, fora do ork, nao chega ao ledger e
- * nao entra aqui. Por isso o canario `fx-pedido-colado` e a regra nos adaptadores existem.
+ * nao entra aqui. Por isso o cenario `fx-pedido-colado` e a regra nos adaptadores existem.
  *
  * Funcoes puras sobre eventos: nao leem disco nem relogio. Ausencia de pedido e zero pedidos, e a
  * mediana sem resposta e `null`, nunca zero inventado. A unica leitura de disco e

package/dist/index.js

@@ -633,11 +633,12 @@ function comandoOnboarding(args) {
     if (sub === 'reset' && (args.posicionais.length > 3 || 'conteudo' in args.opcoes))
         invalido();
     if (sub === 'sync' && 'por' in args.opcoes)
-        throw new Error('onboarding.input.invalid: sync não aceita --por; informe autoria em set ou reset.');
+        throw new Error((0, locale_1.msg)().onboarding.syncPor);
     const carregado = (0, manifest_1.exigirManifesto)(), raiz = carregado.raiz, por = texto(args.opcoes.por) ?? 'owner';
     if (sub === 'sync') {
-        const r = (0, memoria_1.sincronizarOnboarding)(carregado);
-        console.log(args.opcoes.json === true ? JSON.stringify(r, null, 2) : `${r.regime}${r.motivo ? ` (${r.motivo})` : ''}: ${r.detalhe}`);
+        const r = (0, locale_1.comLocale)('pt-BR', () => (0, memoria_1.sincronizarOnboarding)(carregado));
+        console.log(args.opcoes.json === true ? JSON.stringify(r, null, 2)
+            : (0, locale_1.msg)().onboarding.syncResultado(r.regime, r.motivo, r.respondidas, r.gravadas, r.duplicadas, r.falhas));
         return 0;
     }
     let estado;
@@ -3042,7 +3043,7 @@ function comandoMaster(args) {
             return 0;
         }
         if (sub !== 'enviar')
-            throw new Error('uso: ork master digest <enviar|preview|responder>');
+            throw new Error((0, locale_1.msg)().cli.masterDigestUso);
         const r = (0, master_digest_1.enviarDigest)({ raiz: carregado.raiz });
         console.log(JSON.stringify(r, null, 2));
         return r.code;
@@ -3062,14 +3063,14 @@ function comandoMaster(args) {
             const partes = (texto(args.opcoes.resposta) ?? '').trim().split(/\s+/);
             const classe = (0, master_2.parseClasse)(partes[3]);
             if (partes.length !== 4 || partes[0] !== 'ratificar' || !classe)
-                throw new Error('resposta deve ser ratificar <thread> <assinatura> <classe>');
+                throw new Error((0, locale_1.msg)().cli.masterRatificarUso);
             selecao = [{ thread: partes[1], assinatura: partes[2], classe }];
         }
         else {
             selecao = (texto(args.opcoes.aceitar) ?? '').split(',').map(v => {
                 const partes = v.trim().split(':');
                 if (partes.length !== 2 || !/^[a-f0-9]{64}$/.test(partes[1]))
-                    throw new Error('seleção deve ser thread:assinatura');
+                    throw new Error((0, locale_1.msg)().cli.masterSelecaoUso);
                 return { thread: partes[0], assinatura: partes[1] };
             });
         }
@@ -3411,7 +3412,9 @@ function comandoDocs(args) {
     if (sub === 'verificar') {
         // RM-037 (fatia 3, GO-FIX 2): o CI passa --pr no pull_request; no push da main as duas regras novas reprovam.
         // RM-061 (F3b, G4): verifica no escopo pt-BR, como o `--json` leva os achados; o texto os remonta no locale do comando.
-        const { docs, achados } = (0, locale_1.comLocale)('pt-BR', () => (0, docs_1.verificarDocs)(raiz, { baseBranch, ajudaDoCli: AJUDA, pr: args.opcoes.pr === true }));
+        const threadDaWorktree = (0, docs_1.escopoPadraoDoSync)(raiz).thread;
+        const baseCarimbada = threadDaWorktree ? (0, thread_1.lerThread)(raiz, threadDaWorktree).base?.commit : undefined;
+        const { docs, achados } = (0, locale_1.comLocale)('pt-BR', () => (0, docs_1.verificarDocs)(raiz, { baseBranch, baseCarimbada, ajudaDoCli: AJUDA, pr: args.opcoes.pr === true }));
         if (args.opcoes.json === true) {
             console.log(JSON.stringify({ paginas: docs.length, erros: achados.filter((a) => a.gravidade === 'erro').length,
                 achados }, null, 2));
@@ -3619,9 +3622,9 @@ function comandoAdapter(args) {
     return 2;
 }
 /**
- * `ork eval`: canarios de comportamento e o corpus das skills finas (bloco B4).
+ * `ork eval`: cenarios de comportamento e o corpus das skills finas (bloco B4).
  *
- * Skill sem eval nao entra, e comportamento sem canario tambem nao. O comando sai diferente
+ * Skill sem eval nao entra, e comportamento sem cenario tambem nao. O comando sai diferente
  * de zero em qualquer falha, para o CI do kit poder barrar merge sem eval.
  */
 function comandoEval(args) {
@@ -3634,8 +3637,8 @@ function comandoEval(args) {
     const r = (0, evalrunner_1.rodarEval)({
         catalogo,
         skills: lista(args.opcoes.skill),
-        canarios: lista(args.opcoes.canario) ?? lista(args.opcoes.fixture),
-        soCanarios: args.opcoes['so-canarios'] === true,
+        cenarios: lista(args.opcoes.cenario) ?? lista(args.opcoes.fixture),
+        soCenarios: args.opcoes['so-cenarios'] === true,
         soSkills: args.opcoes['so-skills'] === true,
     });
     if (args.opcoes.json === true) {
@@ -4435,8 +4438,10 @@ function executarComando(argvBruto) {
     const projeto = proprio ? undefined : extraida.projeto;
     // Helper fixo do host confiável: o projeto vem da instalação, nunca de toolargs.
     if (argv[0] === 'receipt-verifiers') {
-        if (argv.length !== 2 || argv[1] !== '--json' || projeto !== undefined)
-            throw Error('uso: ork receipt-verifiers --json');
+        if (argv.length !== 2 || argv[1] !== '--json' || projeto !== undefined) {
+            (0, locale_1.ativarLocale)(localeDaAjuda());
+            throw new locale_1.ErroDoCatalogo((m) => m.cli.receiptVerifiersUso);
+        }
         const root = process.env.ORK_HITL_ROOT;
         const privateKey = Object.keys(process.env).some(name => /^ORK_HITL_(?:INGRESS_KEY|NATIVE_KEY)/.test(name));
         if (root !== undefined || privateKey) {
@@ -4452,13 +4457,14 @@ function executarComando(argvBruto) {
         return 0;
     }
     if (argv[0] === 'maestro') {
+        const textos = (0, locale_1.msg)(localeDaAjuda(projeto)).maestro;
         if (argv.length === 2 && argv[1] === '--help')
-            return (0, maestro_cli_1.runMaestroCli)(argv.slice(1));
+            return (0, maestro_cli_1.runMaestroCli)(argv.slice(1), process.cwd(), {}, undefined, textos);
         // RM-052: o alvo explicito vira SELECAO entre as raizes permitidas; sem ele, o cwd de sempre. O
         // snapshot ja declara o projeto consultado (project.root, notConsulted): sem a linha da fatia 2.
         const alvo = fixarAlvoDoProcesso(projeto, false);
-        return alvo ? (0, maestro_cli_1.runMaestroCli)(argv.slice(1), alvo.raiz, { allowedRoots: [alvo.raiz], selected: alvo.raiz })
-            : (0, maestro_cli_1.runMaestroCli)(argv.slice(1));
+        return alvo ? (0, maestro_cli_1.runMaestroCli)(argv.slice(1), alvo.raiz, { allowedRoots: [alvo.raiz], selected: alvo.raiz }, undefined, textos)
+            : (0, maestro_cli_1.runMaestroCli)(argv.slice(1), process.cwd(), {}, undefined, textos);
     }
     const args = parseArgs(argv);
     const comando = args.posicionais[0];
@@ -4472,14 +4478,21 @@ function executarComando(argvBruto) {
         console.log((0, locale_1.msg)().ajuda.texto(dadosDaAjuda()));
         return 0;
     }
+    // F3e (D2): a recusa do projeto-alvo e os usos das rotas cobertas acontecem antes do manifesto efetivo.
+    // Resolva a lingua aqui; `--json` continua fora e um `mcp serve` valido desliga o locale antes de servir.
+    if ((0, locale_1.cobreLocale)(args.posicionais, args.opcoes)) {
+        (0, locale_1.ativarLocale)(localeDaAjuda(projeto));
+        (0, locale_1.ligarRemontagem)(true);
+    }
     if (!COMANDOS_SEM_PROJETO.has(comando) && !proprio) {
         fixarAlvoDoProcesso(projeto, !SEM_DECLARACAO_DO_PROJETO.has(`${comando} ${args.posicionais[1] ?? ''}`.trim()));
     }
     else if (projeto !== undefined && comando !== 'projetos') {
+        const mp = (0, locale_1.msg)().projetos;
         throw new Error(comando === 'init'
-            ? 'uso: ork init cria o projeto no diretório atual; entre nele e rode ork init, sem --projeto'
-            : comando === 'mcp' ? 'uso: o servidor MCP recebe a raiz por --project <raiz absoluta>, não por --projeto'
-                : `uso: ork ${comando} não lê projeto; tire --projeto`);
+            ? mp.initNaoLeProjeto
+            : comando === 'mcp' ? mp.mcpNaoLeProjeto
+                : mp.comandoNaoLeProjeto(comando));
     }
     const nomesHerdados = (0, runtime_ambiente_1.nomesDeProviderAtivos)();
     const ambienteManifesto = (0, manifest_1.carregarManifesto)();
@@ -4495,10 +4508,6 @@ function executarComando(argvBruto) {
     // CLI por locale (RM-061, EN1 e EN7): a escolha do onboarding (owner.language) ou o LC_ALL/LC_MESSAGES/LANG
     // decidem a lingua do TEXTO dos comandos cobertos (`cobreLocale`); `--json` e contrato, e os recortes ainda
     // fora do catalogo (`doctor --modo` e os subcomandos fora da lista) ficam em pt-BR.
-    if ((0, locale_1.cobreLocale)(args.posicionais, args.opcoes)) {
-        (0, locale_1.ativarLocale)((0, locale_1.resolverLocale)(ambienteManifesto?.manifesto.owner?.language).locale);
-        (0, locale_1.ligarRemontagem)(true);
-    }
     switch (comando) {
         case 'mcp': {
             const projeto = texto(args.opcoes.project), host = texto(args.opcoes.host), threadId = texto(args.opcoes.thread);
@@ -4535,6 +4544,9 @@ function executarComando(argvBruto) {
                     .catch(e => { console.error((0, locale_1.msg)().operacao.restante.mcp.erro(e.message)); process.exitCode = 1; });
                 return 0;
             }
+            // O servidor e contrato com hosts e nao ganha uma moldura inglesa por herdar o locale do erro de uso.
+            (0, locale_1.ativarLocale)(undefined);
+            (0, locale_1.ligarRemontagem)(false);
             void Promise.resolve().then(() => __importStar(require('./mcp-server'))).then(({ servirMcp }) => servirMcp({ projeto, host, threadId, dispatchId, nomesProviderHerdados: nomesHerdados, transporteShip: transporteShip, permissoesFilho: permissoesFilho })).catch(e => { console.error(`mcp: ${e.message}`); process.exitCode = 1; });
             return 0;
         }
@@ -4543,7 +4555,7 @@ function executarComando(argvBruto) {
                 const bruto = texto(args.opcoes.modo);
                 if (args.posicionais.length !== 1 || !bruto ||
                     Object.keys(args.opcoes).some(k => k !== 'modo') || argv.filter(a => a === '--modo' || a.startsWith('--modo=')).length !== 1)
-                    throw Error(`uso: ork doctor --modo ${modos_1.ORDEM_DOS_MODOS.join('|')}`);
+                    throw Error((0, locale_1.msg)().doctor.modoUso(modos_1.ORDEM_DOS_MODOS.join('|')));
                 const r = (0, preflight_1.preflight)((0, manifest_1.diretorioDoProjeto)(), (0, modos_1.exigirModoVivo)(bruto), nomesHerdados);
                 console.log((0, preflight_1.textoPreflight)(r));
                 return r.prontoPrimeiroBloco ? 0 : 1;
@@ -4679,10 +4691,9 @@ function executarComando(argvBruto) {
                 if (!host || !['claude-code', 'codex'].includes(host) || args.posicionais.length !== 3 ||
                     Object.keys(args.opcoes).some(k => !['dry-run', 'json'].includes(k)) ||
                     Object.values(args.opcoes).some(v => v !== true))
-                    throw Error('uso: ork experiencia uninstall claude-code|codex [--dry-run] [--json]');
+                    throw Error((0, locale_1.msg)().onboarding.experienciaUninstallUso);
                 const r = (0, hosts_2.desinstalarExperiencia)((0, manifest_1.exigirManifesto)().raiz, host, args.opcoes['dry-run'] === true);
-                console.log(args.opcoes.json ? JSON.stringify(r, null, 2) :
-                    `${r.dryRun ? 'Simulação de remoção' : 'Remoção concluída'}: ${r.arquivos.length} arquivo(s). O adaptador permanece instalado. Para manter o pacote desativado, configure owner.experience:false no onboarding.`);
+                console.log(args.opcoes.json ? JSON.stringify(r, null, 2) : (0, locale_1.msg)().onboarding.experienciaUninstall(r.dryRun, r.arquivos.length));
                 return 0;
             }
             if ((args.posicionais[1] ?? 'show') !== 'show' || args.posicionais.length > 2 ||
@@ -4773,7 +4784,7 @@ function executarComando(argvBruto) {
         case 'recall':
             return comandoRecall(args);
         case 'brain': {
-            const result = (0, company_brain_cli_1.runBrain)((0, manifest_1.exigirManifesto)(), args.posicionais[1] ?? 'status', args.opcoes, args.posicionais.slice(2));
+            const result = (0, locale_1.comLocale)('pt-BR', () => (0, company_brain_cli_1.runBrain)((0, manifest_1.exigirManifesto)(), args.posicionais[1] ?? 'status', args.opcoes, args.posicionais.slice(2)));
             console.log(JSON.stringify(result, null, 2));
             return ['ok', 'empty', 'unknown', 'withheld', 'applied', 'rolled-back'].includes(result.state) ? 0 : 1;
         }
@@ -4801,7 +4812,14 @@ function executarComando(argvBruto) {
         case 'ship':
             return comandoShip(args);
         case 'activation':
-            return (0, write_activation_1.comandoAtivacao)((0, manifest_1.exigirManifesto)(), args);
+            try {
+                return (0, locale_1.comLocale)('pt-BR', () => (0, write_activation_1.comandoAtivacao)((0, manifest_1.exigirManifesto)(), args));
+            }
+            catch (e) {
+                if (e.message === 'uso: ork activation plan|status|enable|disable')
+                    throw new locale_1.ErroDoCatalogo((m) => m.cli.activationUso);
+                throw e;
+            }
         case 'lease':
             return comandoLease(args);
         case 'conducao':

package/dist/init.js

@@ -267,7 +267,7 @@ policies:
  * exemplo) gravava manifesto, `AGENTS.md` e `.orkastery/` ali e saia 0; um repositorio criado depois
  * dentro dessa pasta herdava o manifesto de fora, com outro nome e outra abbrev, e o doctor dizia PRONTO.
  * A CLI recusa antes de gravar qualquer coisa. A funcao `init` segue aceitando qualquer pasta (demo e
- * canarios montam o projeto por ela).
+ * cenarios montam o projeto por ela).
  */
 function exigirRepositorioParaInit(dir) {
     const r = (0, util_1.exec)('git', ['rev-parse', '--is-inside-work-tree'], dir);

package/dist/intelligence-graph-cli.js

@@ -38,6 +38,7 @@ exports.descreverVersoes = descreverVersoes;
 exports.correcaoDosAnalisadores = correcaoDosAnalisadores;
 exports.checarAnalisadoresDoGrafo = checarAnalisadoresDoGrafo;
 exports.lerPedido = lerPedido;
+exports.linhasDaExtracao = linhasDaExtracao;
 exports.situacaoNaArvore = situacaoNaArvore;
 exports.executarGrafo = executarGrafo;
 /**
@@ -128,6 +129,7 @@ exports.USO_DO_GRAFO = [
 exports.TEXTOS_DO_GRAFO = {
     uso: exports.USO_DO_GRAFO.split('\n'),
     erroUso: (motivo) => `grafo.uso: ${motivo}`,
+    erroTipado: (mensagem) => mensagem,
     motivos: {
         semSub: 'falta o subcomando', desconhecido: (sub) => `subcomando desconhecido: ${sub}`,
         repetida: (nome) => `--${nome} repetida`, semValor: (nome) => `--${nome} nao leva valor`,
@@ -149,6 +151,15 @@ exports.TEXTOS_DO_GRAFO = {
         naoConferido: (motivo) => `  incremental  nao conferido: ${motivo}`,
         aprovado: 'aprovado',
         semBase: 'sem base',
+        extracao: {
+            lista: (itens) => itens.length ? ` (${itens.slice(0, 5).join(', ')}${itens.length > 5 ? ` e mais ${itens.length - 5}` : ''})` : '',
+            incremental: (base, alterados, novos, removidos) => `  extracao     incremental a partir do indice de ${base}: ${alterados} alterado(s), ${novos} novo(s), ${removidos} removido(s)`,
+            tsInteiro: (motivo) => `TypeScript inteiro (${motivo ?? ''})`,
+            tsParcial: (reextraidos, lista, programa, reaproveitados) => `TypeScript parcial, ${reextraidos} reextraido(s)${lista} num programa de ${programa}, ${reaproveitados} da base`,
+            tsBase: (reaproveitados) => `TypeScript todo da base (${reaproveitados})`,
+            markdown: (reextraidos, lista, reaproveitados) => `               Markdown: ${reextraidos} reextraido(s)${lista}, ${reaproveitados} da base`,
+            completa: (motivo) => `  extracao     completa${motivo ? `: ${motivo}` : ''}`,
+        },
     },
     status: {
         titulo: (head, arvore) => `grafo: HEAD ${head}, arvore ${arvore}`,
@@ -282,23 +293,24 @@ const contagem = (o) => Object.entries(o).map(([k, v]) => `${k}=${v}`).join(' ')
 /** Ate cinco caminhos e quantos ficaram de fora. */
 const alguns = (lista) => (lista.length ? ` (${lista.slice(0, 5).join(', ')}${lista.length > 5 ? ` e mais ${lista.length - 5}` : ''})` : '');
 /** KG4: como a extracao rodou, a base e o que veio dela, ou por que foi completa. */
-function linhasDaExtracao(r) {
+function linhasDaExtracao(r, mi) {
     if (r.modo === null)
         return [];
     const a = r.reaproveitamento;
+    const me = mi.extracao;
     if (r.modo === 'incremental' && r.base && a) {
         // Desestruturado: o lint de horario le o campo de nome curto do TypeScript como instante.
         const { ts: doTs, md: doMd, mudanca } = a;
-        const ts = doTs.modo === 'inteiro' ? `TypeScript inteiro (${doTs.motivo})`
-            : doTs.modo === 'parcial' ? `TypeScript parcial, ${doTs.reextraidos.length} reextraido(s)${alguns(doTs.reextraidos)} num programa de ${doTs.programa}, ${doTs.reaproveitados} da base`
-                : `TypeScript todo da base (${doTs.reaproveitados})`;
+        const ts = doTs.modo === 'inteiro' ? me.tsInteiro(doTs.motivo)
+            : doTs.modo === 'parcial' ? me.tsParcial(doTs.reextraidos.length, me.lista(doTs.reextraidos), doTs.programa, doTs.reaproveitados)
+                : me.tsBase(doTs.reaproveitados);
         return [
-            `  extracao     incremental a partir do indice de ${r.base.revision.slice(0, 12)}: ${mudanca.alterados} alterado(s), ${mudanca.novos} novo(s), ${mudanca.removidos} removido(s)`,
+            me.incremental(r.base.revision.slice(0, 12), mudanca.alterados, mudanca.novos, mudanca.removidos),
             `               ${ts}`,
-            `               Markdown: ${doMd.reextraidos.length} reextraido(s)${alguns(doMd.reextraidos)}, ${doMd.reaproveitados} da base`,
+            me.markdown(doMd.reextraidos.length, me.lista(doMd.reextraidos), doMd.reaproveitados),
         ];
     }
-    return [`  extracao     completa${r.motivo_completo ? `: ${r.motivo_completo}` : ''}`];
+    return [me.completa(r.motivo_completo)];
 }
 function indexar(ctx, p) {
     const r = (0, intelligence_graph_index_1.construirIndice)(ctx, { verificar: p.bandeiras.has('verificar'), forcar: p.bandeiras.has('forcar') });
@@ -314,7 +326,7 @@ function indexar(ctx, p) {
         mi.campo(mi.campos.conferencia, mi.conferencia(m.conferencia.fontes, m.conferencia.evidencias)),
         mi.campo(mi.campos.nos, contagem(m.contagens.nos)), mi.campo(mi.campos.arestas, contagem(m.contagens.arestas)),
         mi.campo(mi.campos.lugar, `${r.dir} (${mb(m.graph_bytes + m.report_bytes + m.units_bytes)})`),
-        ...linhasDaExtracao(r),
+        ...linhasDaExtracao(r, mi),
     ];
     if (r.motivo)
         linhas.push(mi.campo(mi.campos.motivo, r.motivo));
@@ -757,6 +769,12 @@ const erroEmJson = (ctx, e, compacto, schema = intelligence_graph_query_1.CONSUL
     ctx.escrever(compacto ? JSON.stringify(r) : JSON.stringify(r, null, 2));
     return 1;
 };
+/** Traduz a mensagem sem apagar a classe, os candidatos ou o stack do erro tipado. */
+const erroHumano = (ctx, e) => {
+    const erro = e instanceof Error ? e : new Error(String(e));
+    erro.message = textosDe(ctx).erroTipado(erro.message);
+    return erro;
+};
 /** `ork grafo <subcomando> ...`: devolve o codigo de saida; sem `--json`, o erro de uso ou tipado e lancado. */
 function executarGrafo(argv, ctx) {
     const schema = argv[0] === 'contexto' ? intelligence_graph_contexto_1.CONTEXTO_SCHEMA : intelligence_graph_query_1.CONSULTA_SCHEMA;
@@ -786,7 +804,7 @@ function executarGrafo(argv, ctx) {
     }
     catch (e) {
         if (!p.bandeiras.has('json'))
-            throw e;
+            throw erroHumano(ctx, e);
         return erroEmJson(ctx, e, compacto, schema);
     }
 }

package/dist/locale-ajuda.js

@@ -364,8 +364,8 @@ Uso: ork [--projeto <nome|caminho>] <comando> [argumentos]
         [--aceitar-catalogo <arquivo>]           sobrescreve a copia com o catalogo, arquivo a arquivo
         [--manter-copia <arquivo>]               deixa a copia como esta, arquivo a arquivo
 
-  eval [--skill S] [--canario C]            Canarios de comportamento + corpus das skills finas
-        [--so-canarios] [--so-skills] [--json]   (sai != 0 em qualquer falha)
+  eval [--skill S] [--cenario C]            Cenarios de comportamento + corpus das skills finas
+        [--so-cenarios] [--so-skills] [--json]   (sai != 0 em qualquer falha)
 
   audit packs [--estagio E] [--pack P]      Os 7 packs, o estagio que os ativa e a postura
   audit run <pack> [--profile P]            Monta o prompt do pack e despacha pelo runtime adapter
@@ -413,7 +413,7 @@ Fases: GOAL PLAN GO CHECK SHIP MASTER. Modos: ${v.tags}.
 Familias de lease: main-tree, worktree-write:<thread>, path:<glob>, board:<card>, service:<porta>.
 Ciclos: greenfield, merge-branch, goal-plan, gap, feature-xl-faseada.
 Fontes de medida do gate de tokens: runtime_reported, estimated, informada, unavailable.
-Hosts de Camada 1: claude-code, codex, hermes, openclaw. Canarios: fx-happy, fx-hallucination,
+Hosts de Camada 1: claude-code, codex, hermes, openclaw. Cenarios: fx-happy, fx-hallucination,
 fx-stale-base, fx-wiki-destroy, fx-schema-drift, fx-concurrency.
 Packs de auditoria: clean-code, reuse, architecture, data-model, ux, security-privacy, process.
 Superficie de ataque de rede (SP8..SP12, varredura deterministica): rota sem auth, endpoint de
@@ -778,8 +778,8 @@ Usage: ork [--projeto <name|path>] <command> [arguments]
         [--aceitar-catalogo <file>]              overwrites the copy with the catalog, file by file
         [--manter-copia <file>]                  keeps the copy as it is, file by file
 
-  eval [--skill S] [--canario C]            Behavior canaries + corpus of the thin skills
-        [--so-canarios] [--so-skills] [--json]   (exits != 0 on any failure)
+  eval [--skill S] [--cenario C]            Behavior scenarios + corpus of the thin skills
+        [--so-cenarios] [--so-skills] [--json]   (exits != 0 on any failure)
 
   audit packs [--estagio E] [--pack P]      The 7 packs, the stage that activates them and the posture
   audit run <pack> [--profile P]            Builds the pack prompt and dispatches through the runtime adapter
@@ -827,7 +827,7 @@ Phases: GOAL PLAN GO CHECK SHIP MASTER. Modes: ${v.tags}.
 Lease families: main-tree, worktree-write:<thread>, path:<glob>, board:<card>, service:<port>.
 Cycles: greenfield, merge-branch, goal-plan, gap, feature-xl-faseada.
 Token gate measurement sources: runtime_reported, estimated, informada, unavailable.
-Layer 1 hosts: claude-code, codex, hermes, openclaw. Canaries: fx-happy, fx-hallucination,
+Layer 1 hosts: claude-code, codex, hermes, openclaw. Scenarios: fx-happy, fx-hallucination,
 fx-stale-base, fx-wiki-destroy, fx-schema-drift, fx-concurrency.
 Audit packs: clean-code, reuse, architecture, data-model, ux, security-privacy, process.
 Network attack surface (SP8..SP12, deterministic scan): route without auth, exposed admin