@orkastery/cli 0.4.3 → 0.5.1

package/dist/manifest.js

@@ -37,10 +37,13 @@ var __importStar = (this && this.__importStar) || (function () {
     };
 })();
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.LIMITE_MANIFESTO_BYTES = exports.DIR_ESTADO = exports.NOME_MANIFESTO_LEGADO = exports.NOME_MANIFESTO = void 0;
+exports.EMBEDDING_PADRAO = exports.LIMITE_MANIFESTO_BYTES = exports.DIR_ESTADO = exports.NOME_MANIFESTO_LEGADO = exports.NOME_MANIFESTO = void 0;
+exports.fixarDiretorioDoProjeto = fixarDiretorioDoProjeto;
+exports.diretorioDoProjeto = diretorioDoProjeto;
 exports.acharRaiz = acharRaiz;
 exports.dirEstado = dirEstado;
 exports.validarOptInPlaybook = validarOptInPlaybook;
+exports.configDeEmbedding = configDeEmbedding;
 exports.carregarManifesto = carregarManifesto;
 exports.exigirManifesto = exigirManifesto;
 const fs = __importStar(require("node:fs"));
@@ -53,13 +56,28 @@ const slug_1 = require("./slug");
 const util_1 = require("./util");
 const delegation_1 = require("./delegation");
 const horario_1 = require("./horario");
+const experiencia_1 = require("./experiencia");
+const runtime_ambiente_1 = require("./runtime-ambiente");
+const orkmind_1 = require("./orkmind");
 exports.NOME_MANIFESTO = 'orkastery.yaml';
 exports.NOME_MANIFESTO_LEGADO = 'devmaster.yaml';
 exports.DIR_ESTADO = '.orkastery';
 /** Limite duro: o manifesto nao pode virar o novo arquivo de 100 KB. */
 exports.LIMITE_MANIFESTO_BYTES = 16384;
+let diretorioFixado = null;
+/**
+ * RM-052: o projeto-alvo fixado pelo CLI (`--projeto`, `ORK_PROJETO`, host sem cwd) vira o ponto
+ * de partida padrao das raizes. Sem ele, vale o cwd, como sempre. Quem fixa e `fixarProjetoAlvo`.
+ */
+function fixarDiretorioDoProjeto(dir) {
+    diretorioFixado = dir;
+}
+/** De onde as raizes padrao partem: o projeto-alvo fixado ou, sem ele, o cwd do processo. */
+function diretorioDoProjeto() {
+    return diretorioFixado ?? process.cwd();
+}
 /** Raiz do projeto: o diretorio que contem o manifesto; senao, a raiz do repositorio git. */
-function acharRaiz(dirInicial = process.cwd()) {
+function acharRaiz(dirInicial = diretorioDoProjeto()) {
     const porManifesto = (0, util_1.subirAte)(dirInicial, exports.NOME_MANIFESTO);
     if (porManifesto)
         return porManifesto;
@@ -116,12 +134,59 @@ function prazosDoVerify(verify, erros) {
         saida.timeout_ms_por_comando = porComando;
     return saida;
 }
+/**
+ * RM-037 (rm037defeito, defeito 5): `ci.external_repositories`, mapa `dono/nome` para o check exigido no
+ * head do PR (texto vazio ou nulo: repositorio sem CI). Forma invalida e erro do manifesto, nunca adivinhada.
+ */
+function repositoriosExternos(v, erros) {
+    if (v === undefined || v === null)
+        return {};
+    if (typeof v !== 'object' || Array.isArray(v)) {
+        erros.push('ci.external_repositories deve ser um mapa "dono/nome": "check exigido" (vazio para repositorio sem CI)');
+        return {};
+    }
+    const r = {};
+    for (const [repo, check] of Object.entries(v)) {
+        if (!/^[A-Za-z0-9_.-]+\/[A-Za-z0-9_.-]+$/.test(repo)) {
+            erros.push(`ci.external_repositories: "${repo}" nao e dono/nome do GitHub`);
+            continue;
+        }
+        if (check !== null && typeof check !== 'string') {
+            erros.push(`ci.external_repositories.${repo}: o check exigido e texto (vazio para sem CI)`);
+            continue;
+        }
+        r[repo] = (check ?? '').trim();
+    }
+    return r;
+}
 function booleano(v, padrao) {
     return typeof v === 'boolean' ? v : padrao;
 }
 function mapa(v) {
     return v && typeof v === 'object' && !Array.isArray(v) ? v : {};
 }
+/**
+ * RM-031 KG5 (D2): `grafo.mcp` so liga com o booleano `true`. Ausente vale `false`; texto que parece
+ * booleano, outro tipo ou `grafo` que nao e mapa tambem valem `false`, com aviso: ligar expoe as tools
+ * do grafo, e na duvida fica desligado. Chave desconhecida em `grafo` so avisa.
+ */
+function lerGrafo(v, avisos) {
+    const mostrar = (x) => JSON.stringify(x).slice(0, 80);
+    if (v === undefined || v === null)
+        return { mcp: false };
+    if (typeof v !== 'object' || Array.isArray(v)) {
+        avisos.push(`grafo deve ser um mapa com mcp: true ou false; vale mcp: false (${mostrar(v)} nao reconhecido)`);
+        return { mcp: false };
+    }
+    for (const chave of Object.keys(v))
+        if (chave !== 'mcp')
+            avisos.push(`grafo.${chave} desconhecida; o bloco grafo so tem mcp`);
+    const mcp = v.mcp;
+    if (mcp === undefined || mcp === null || typeof mcp === 'boolean')
+        return { mcp: mcp === true };
+    avisos.push(`grafo.mcp deve ser true ou false; vale false (${mostrar(mcp)} nao reconhecido)`);
+    return { mcp: false };
+}
 /** Mesmo contrato na leitura do YAML e nos consumidores de manifesto em memoria. */
 function validarOptInPlaybook(valor) {
     if (valor === undefined)
@@ -133,6 +198,81 @@ function validarOptInPlaybook(valor) {
     }
     return valor.ativo;
 }
+/** I-38 (D5): sem o bloco `memory.embedding`, os embeddings ficam desligados. */
+exports.EMBEDDING_PADRAO = Object.freeze({
+    provider: 'none', model: '', dim: 1024, api_key_env: '', fallback_model: '', max_tokens_por_execucao: 1_000_000,
+});
+const CHAVES_DE_EMBEDDING = ['provider', 'model', 'dim', 'api_key_env', 'fallback_model', 'max_tokens_por_execucao'];
+/** Valor que parece segredo (URL, prefixo de chave, sequencia longa) nunca e repetido num erro. */
+function exibir(v) {
+    const t = typeof v === 'string' ? v : JSON.stringify(v);
+    return /:\/\/|\bsk-|[A-Za-z0-9_-]{32,}/.test(t) ? '(valor omitido: parece segredo)' : JSON.stringify(v);
+}
+/**
+ * I-38 (D5): le e valida `memory.embedding`. A chave so entra pelo NOME da variavel: valor com
+ * cara de chave ou DSN reprova o manifesto, e nome da lista de provider pago tambem, porque a
+ * entrada do `ork` apagaria a variavel sob `subscription-only` e o preflight reprovaria o codex.
+ */
+function lerEmbedding(bruto, variavelDaDsn, erros) {
+    if (bruto === undefined || bruto === null)
+        return undefined;
+    if (typeof bruto !== 'object' || Array.isArray(bruto)) {
+        erros.push('memory.embedding precisa ser um bloco com provider, model, dim, api_key_env, fallback_model e max_tokens_por_execucao');
+        return undefined;
+    }
+    const e = bruto;
+    for (const chave of Object.keys(e)) {
+        if (!CHAVES_DE_EMBEDDING.includes(chave)) {
+            erros.push(`memory.embedding.${chave} nao existe (a chave entra pelo ambiente: declare so o NOME em api_key_env)`);
+        }
+    }
+    const provider = texto(e.provider, exports.EMBEDDING_PADRAO.provider).trim();
+    if (provider !== 'none' && provider !== 'openrouter') {
+        erros.push(`memory.embedding.provider invalido: ${exibir(provider)} (aceitos: none, openrouter)`);
+    }
+    const model = texto(e.model, '').trim();
+    const apiKeyEnv = texto(e.api_key_env, '').trim();
+    const fallback = texto(e.fallback_model, '').trim();
+    const inteiro = (chave, v, padrao, min, max) => {
+        if (v === undefined || v === null)
+            return padrao;
+        const n = typeof v === 'number' ? v : typeof v === 'string' && v.trim() !== '' ? Number(v) : NaN;
+        if (!Number.isInteger(n) || n < min || n > max) {
+            erros.push(`memory.embedding.${chave} precisa ser inteiro entre ${min} e ${max} (recebido ${exibir(v)})`);
+            return padrao;
+        }
+        return n;
+    };
+    const dim = inteiro('dim', e.dim, exports.EMBEDDING_PADRAO.dim, 32, 4096);
+    const teto = inteiro('max_tokens_por_execucao', e.max_tokens_por_execucao, exports.EMBEDDING_PADRAO.max_tokens_por_execucao, 1, 10_000_000);
+    if (apiKeyEnv.includes('://') || /^sk-/i.test(apiKeyEnv)) {
+        erros.push('memory.embedding.api_key_env recebe o NOME da variavel de ambiente com a chave, nunca o valor da chave nem uma DSN');
+    }
+    else if (apiKeyEnv !== '' && !/^[A-Z][A-Z0-9_]*$/.test(apiKeyEnv)) {
+        erros.push('memory.embedding.api_key_env invalido: esperado nome de variavel de ambiente, [A-Z][A-Z0-9_]* (o valor recebido nao e repetido)');
+    }
+    else if (runtime_ambiente_1.ENVS_DE_PROVIDER_PAGO.includes(apiKeyEnv)) {
+        erros.push(`memory.embedding.api_key_env nao pode ser ${apiKeyEnv}: nomes de provider pago sao removidos sob subscription-only; use uma chave dedicada com nome proprio`);
+    }
+    else if (apiKeyEnv !== '' && apiKeyEnv === variavelDaDsn) {
+        erros.push('memory.embedding.api_key_env nao pode repetir memory.database_url_env: a DSN nunca vai ao provider');
+    }
+    if (provider === 'openrouter') {
+        if (!orkmind_1.MODELO_DE_EMBEDDING.test(model))
+            erros.push(`memory.embedding.model invalido: ${exibir(model)} (esperado org/nome, por exemplo qwen/qwen3-embedding-8b)`);
+        if (apiKeyEnv === '')
+            erros.push('memory.embedding.api_key_env e obrigatorio com provider openrouter (o NOME da variavel com a chave dedicada)');
+    }
+    if (fallback !== '' && !orkmind_1.MODELO_DE_EMBEDDING.test(fallback)) {
+        erros.push(`memory.embedding.fallback_model invalido: ${exibir(fallback)} (esperado org/nome de um modelo do Hugging Face)`);
+    }
+    return { provider: provider === 'openrouter' ? 'openrouter' : 'none', model, dim, api_key_env: apiKeyEnv,
+        fallback_model: fallback, max_tokens_por_execucao: teto };
+}
+/** I-38 (D5): leitura unica da configuracao de embedding, com o padrao `none`. */
+function configDeEmbedding(manifesto) {
+    return { ...exports.EMBEDDING_PADRAO, ...(manifesto.memory.embedding ?? {}) };
+}
 /** I-33 (N2): texto e numero que dizem sim ou nao sem ambiguidade; o resto nao e reconhecido. */
 const BOOLEANOS_RECONHECIVEIS = new Map([
     ['true', true], ['yes', true], ['on', true], ['sim', true], ['1', true],
@@ -146,7 +286,7 @@ function booleanoReconhecivel(v) {
     return BOOLEANOS_RECONHECIVEIS.get(v.trim().toLowerCase()) ?? null;
 }
 /** Le e valida o manifesto. Nunca lanca: erros e avisos voltam na estrutura. */
-function carregarManifesto(dirInicial = process.cwd()) {
+function carregarManifesto(dirInicial = diretorioDoProjeto()) {
     const raiz = acharRaiz(dirInicial);
     const candidatos = [
         { caminho: path.join(raiz, exports.NOME_MANIFESTO), legado: false },
@@ -171,6 +311,22 @@ function carregarManifesto(dirInicial = process.cwd()) {
     const fusoDoDono = (0, horario_1.lerFusoDoDono)(mapa(dados.owner).timezone);
     if (fusoDoDono.aviso)
         avisos.push(fusoDoDono.aviso);
+    // Preferência inválida segue o fuso: avisa e cai no padrão, sem parar os comandos (e o próprio
+    // onboarding set, que é o caminho para corrigir).
+    const preferencias = {};
+    for (const chave of ['language', 'depth', 'experience']) {
+        const valor = mapa(dados.owner)[chave];
+        if (valor === undefined)
+            continue;
+        try {
+            Object.assign(preferencias, (0, experiencia_1.validarPreferencias)({ [chave]: valor }));
+        }
+        catch (e) {
+            avisos.push(`${e.message}; vale o padrão até corrigir`);
+        }
+    }
+    if (fusoDoDono.origem === 'manifesto')
+        preferencias.timezone = fusoDoDono.fuso;
     const board = mapa(dados.board);
     const runtime = mapa(dados.runtime);
     const conduction = mapa(dados.conduction);
@@ -299,6 +455,7 @@ function carregarManifesto(dirInicial = process.cwd()) {
         avisos.push('memory.mode: orkmind sem memory.database_url_env: o regime efetivo cai para files ' +
             '(o `ork` nao adivinha DSN, e base alheia e pior do que base nenhuma)');
     }
+    const embedding = lerEmbedding(memory.embedding, variavelDaDsn, erros);
     const bytes = Buffer.byteLength(bruto, 'utf8');
     if (bytes > exports.LIMITE_MANIFESTO_BYTES) {
         erros.push(`manifesto com ${bytes} bytes, acima do limite duro de ${exports.LIMITE_MANIFESTO_BYTES} (prosa vai para memoria com tag, nao para o YAML)`);
@@ -313,7 +470,7 @@ function carregarManifesto(dirInicial = process.cwd()) {
             stage: texto(project.stage, 'nascente') ?? 'nascente',
             repo_root: texto(project.repo_root, raiz),
         },
-        ...(fusoDoDono.origem === 'manifesto' ? { owner: { timezone: fusoDoDono.fuso } } : {}),
+        ...(Object.keys(preferencias).length ? { owner: preferencias } : {}),
         board: {
             adapter: texto(board.adapter, 'hermes-kanban'),
             default: texto(board.default, 'default'),
@@ -350,6 +507,7 @@ function carregarManifesto(dirInicial = process.cwd()) {
             required_for_ship: booleano(ci.required_for_ship, false),
             context: texto(ci.context, 'ork-verify'),
             command: ci.command === null || ci.command === undefined ? undefined : texto(ci.command, ''),
+            external_repositories: repositoriosExternos(ci.external_repositories, erros),
         },
         concurrency: {
             max_parallel_threads: numero(concurrency.max_parallel_threads, 3),
@@ -382,6 +540,7 @@ function carregarManifesto(dirInicial = process.cwd()) {
             cli: texto(memory.cli, 'orkmind'),
             tenant: texto(memory.tenant, '') || nomeProjeto,
             timeout_ms: numero(memory.timeout_ms, 15000),
+            ...(embedding ? { embedding } : {}),
         },
         // Bloco B5: governanca de custo dos auditores. Ausente no manifesto quer dizer
         // "nao declarada", nao "sem limite": a rodada avisa que so `eco` e o escopo
@@ -397,12 +556,14 @@ function carregarManifesto(dirInicial = process.cwd()) {
             compartilhada: booleano(fabrica.compartilhada, false),
             remoto: texto(fabrica.remoto, 'origin'),
         },
+        // RM-031 KG5 (D2): expor as tools do grafo no MCP e opt-in do dono.
+        grafo: lerGrafo(dados.grafo, avisos),
         policies: Object.fromEntries(Object.entries(mapa(dados.policies)).map(([k, v]) => [k, texto(v, '')])),
     };
     return { caminho: achado.caminho, raiz, legado: achado.legado, bytes, manifesto, erros, avisos };
 }
 /** Carrega o manifesto ou encerra com mensagem acionavel (uso nos subcomandos). */
-function exigirManifesto(dirInicial = process.cwd()) {
+function exigirManifesto(dirInicial = diretorioDoProjeto()) {
     const carregado = carregarManifesto(dirInicial);
     if (!carregado) {
         throw new Error(`manifesto ${exports.NOME_MANIFESTO} nao encontrado a partir de ${dirInicial}. Rode: ork init`);

package/dist/master-batch.js

@@ -24,7 +24,7 @@ function listarBatch(raiz, todas = false) {
     return (0, master_1.pendentesDeScore)(raiz, todas).map(p => ({ thread: p.thread.id, nome: p.thread.nome, entregue: p.entregou,
         proposta: p.thread.score_proposto ?? null, assinatura: p.thread.score_proposto ? assinaturaProposta(p.thread.score_proposto) : null }));
 }
-function ratificarBatch(raiz, selecao, por) {
+function ratificarBatch(raiz, selecao, por, prova) {
     (0, master_1.exigirAutoriaHumana)(por);
     if (!selecao.length || new Set(selecao.map(s => s.thread)).size !== selecao.length)
         throw new Error('selecione threads distintas explicitamente');
@@ -34,7 +34,8 @@ function ratificarBatch(raiz, selecao, por) {
         if (!item?.proposta || item.assinatura !== s.assinatura)
             throw new Error(`proposta ausente ou alterada: ${s.thread}; revise o batch`);
         const p = item.proposta;
-        const opcoes = { score: p.valor, justificativa: p.justificativa, classes: s.classe ? [s.classe] : p.classes, resumo: p.resumo, por };
+        const opcoes = { score: p.valor, justificativa: p.justificativa, classes: s.classe ? [s.classe] : p.classes, resumo: p.resumo, por,
+            ...(prova ? { prova } : {}) };
         (0, master_1.preflightMaster)(raiz, s.thread, opcoes);
         return { id: s.thread, opcoes };
     });

package/dist/master-digest.js

@@ -100,14 +100,14 @@ function lerDigest(raiz, semana) {
         throw new Error('digest inválido');
     return job;
 }
-function responderLoteDigest(raiz, resposta, por) {
+function responderLoteDigest(raiz, resposta, por, prova) {
     const partes = resposta.trim().split(/\s+/);
     if (partes.length !== 3 || partes[0] !== 'ratificar-lote')
         throw new Error('resposta de lote inválida');
     const job = lerDigest(raiz, partes[1]);
     if (!job.concluidoEm || partes[2] !== job.assinatura)
         throw new Error('lote não entregue ou assinatura divergente');
-    return (0, master_batch_1.ratificarBatch)(raiz, job.selecao, por);
+    return (0, master_batch_1.ratificarBatch)(raiz, job.selecao, por, prova);
 }
 function enviarDigest(opcoes) {
     const quando = opcoes.quando ?? new Date().toISOString(), semana = sextaLocal(quando);

package/dist/master-nota.js

@@ -0,0 +1,203 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ERRO_PROVA_DE_CANAL = exports.CONTRATO_PEDIDO_DE_NOTA = void 0;
+exports.exigirNotaSemHost = exigirNotaSemHost;
+exports.arquivoDasNotas = arquivoDasNotas;
+exports.pedirNota = pedirNota;
+exports.pedidoDeNotaDoCodigo = pedidoDeNotaDoCodigo;
+exports.textoDoPedidoDeNota = textoDoPedidoDeNota;
+exports.lerNota = lerNota;
+exports.reciboDoCanal = reciboDoCanal;
+exports.mensagemJaUsadaEmNota = mensagemJaUsadaEmNota;
+/**
+ * RM-048 (item 8, D8): a nota do MASTER com prova de origem humana.
+ *
+ * Ate aqui toda nota gravava o nome que viesse em `--por`: a `ork_master` do OpenClaw repassava o
+ * parametro `quem` do modelo, e `master ratificar`, `batch --aceitar` e `digest responder` idem.
+ * `autoriaHumana` so recusa nome de agente; ela mesma diz que nao e autenticacao. O dono pediu que
+ * a nota dada por ferramenta de host passe pela MESMA prova de canal que o gate ja exige.
+ *
+ * O caminho com prova e este, e ele nao cria autenticacao nova:
+ *
+ *   1. `ork master pedir <thread>` guarda um pedido de nota com codigo curto e devolve a linha
+ *      "<codigo> <0 a 5> <porque>" para o canal mostrar ao dono;
+ *   2. o dono responde no Telegram; o ingresso (Hermes ou OpenClaw) assina o texto dele no
+ *      endereco do pulse, com a chave do proprio canal, e o nucleo confere com a mesma
+ *      `autenticarResposta` de sempre, ANTES de ler o conteudo;
+ *   3. a nota e gravada com `por` = o remetente autenticado (`telegram:<id>`) e com o recibo:
+ *      canal, conta, mensagem, instante, o sha da prova e o envelope assinado guardado para a
+ *      auditoria reconferir o HMAC depois.
+ *
+ * O teclado do digest semanal ("ratificar <thread> <assinatura> <classe>") passa pelo mesmo
+ * endereco. E o processo de host (Claude Code, Codex, Hermes, OpenClaw, sessao despachada) que
+ * tenta gravar nota com `--por` recebe `master.prova-de-canal`.
+ *
+ * LIMITE DITO: o canal do processo e declarado pelo ambiente (`canalDoProcesso`). Ele serve para
+ * RECUSAR, nunca para autorizar, e um agente que apague as variaveis do proprio host de proposito
+ * passa como terminal. Essa e a mesma fronteira do `humano-no-cli` do SHIP; fecha-la de vez exige o
+ * dialogo nativo do host para a nota, que fica fora desta entrega.
+ */
+const fs = __importStar(require("node:fs"));
+const path = __importStar(require("node:path"));
+const node_crypto_1 = require("node:crypto");
+const estado_thread_1 = require("./estado-thread");
+const thread_1 = require("./thread");
+const ledger_1 = require("./ledger");
+const thread_close_1 = require("./thread-close");
+const conducao_1 = require("./conducao");
+const pulse_consentimento_1 = require("./pulse-consentimento");
+const monitor_lock_1 = require("./monitor-lock");
+exports.CONTRATO_PEDIDO_DE_NOTA = 'ork.master-nota/v1';
+exports.ERRO_PROVA_DE_CANAL = 'master.prova-de-canal';
+const sha = (s) => (0, node_crypto_1.createHash)('sha256').update(s).digest('hex');
+/**
+ * D8: nota em nome de pessoa, vinda de processo de host, e recusada. O canal e lido SO do
+ * ambiente: `--canal` em argv nao conta, porque quem escreve argv e justamente quem chama.
+ */
+function exigirNotaSemHost(ambiente = process.env) {
+    let canal;
+    try {
+        canal = (0, conducao_1.canalDoProcesso)(undefined, ambiente);
+    }
+    catch {
+        canal = 'mcp';
+    }
+    // B2 do CHECK: `ORK_CANAL=cli` NAO absolve. A sessao despachada herda `ORK_CANAL=cli` quando a
+    // thread e conduzida do terminal, e o Claude Code e o Codex marcam os proprios processos. Qualquer
+    // marca de host ou de despacho recusa, mesmo com o canal declarado como terminal.
+    const marca = canal !== 'cli' ? canal
+        : ambiente.ORK_DISPATCH_ID ? 'sessão despachada (ORK_DISPATCH_ID)'
+            : ambiente.CLAUDECODE === '1' ? 'claude-code (CLAUDECODE)'
+                : ambiente.CODEX_SANDBOX || ambiente.CODEX_SANDBOX_NETWORK_DISABLED ? 'codex (CODEX_SANDBOX)'
+                    : (ambiente.HERMES_HOME ?? '').trim() ? 'hermes (HERMES_HOME)' : undefined;
+    if (marca) {
+        throw new Error(`${exports.ERRO_PROVA_DE_CANAL}: nota em nome de pessoa vinda de ${marca} exige a prova de canal do ingresso. ` +
+            'Peça a nota com ork master pedir <thread>: o dono responde pelo Telegram com o código, e a nota é gravada com o recibo.');
+    }
+}
+function arquivoDasNotas(raiz, estadoDir) {
+    return path.join(estadoDir ?? path.join((0, estado_thread_1.raizDoEstado)(raiz), '.orkastery', 'monitor'), 'master-notas.json');
+}
+function lerNotas(raiz, estadoDir) {
+    const arquivo = arquivoDasNotas(raiz, estadoDir);
+    if (!fs.existsSync(arquivo))
+        return {};
+    const v = JSON.parse(fs.readFileSync(arquivo, 'utf8'));
+    if (v.contrato !== exports.CONTRATO_PEDIDO_DE_NOTA || !v.notas || typeof v.notas !== 'object')
+        throw new Error('pedidos de nota: estado inválido; exige inspeção');
+    return v.notas;
+}
+function gravarNotas(raiz, notas, estadoDir) {
+    const arquivo = arquivoDasNotas(raiz, estadoDir);
+    fs.mkdirSync(path.dirname(arquivo), { recursive: true });
+    const tmp = `${arquivo}.${process.pid}.tmp`;
+    fs.writeFileSync(tmp, JSON.stringify({ contrato: exports.CONTRATO_PEDIDO_DE_NOTA, notas }) + '\n', { mode: 0o600 });
+    fs.renameSync(tmp, arquivo);
+}
+/**
+ * Pede a nota ao dono. Idempotente: a mesma entrega sem nota devolve o MESMO codigo, para a
+ * linha que o dono recebeu nao vencer. So entrega provada recebe pedido de nota.
+ */
+function pedirNota(raiz, thread, opcoes = {}) {
+    const quando = opcoes.quando ?? new Date().toISOString();
+    (0, thread_close_1.exigirEntrega)(raiz, thread);
+    const estadoDir = opcoes.estadoDir ?? path.join((0, estado_thread_1.raizDoEstado)(raiz), '.orkastery', 'monitor');
+    // A4 do CHECK: o registro dos pedidos de nota tem dois escritores (pedir e o receptor do pulse);
+    // um de cada vez, pelo mesmo lock da conversa.
+    return (0, monitor_lock_1.comLockDaConversa)(estadoDir, () => {
+        const notas = lerNotas(raiz, estadoDir);
+        const existente = Object.values(notas).find(n => n.thread === thread);
+        if (existente && !notaDada(raiz, existente))
+            return existente;
+        // A1 do CHECK: o codigo da nota nao repete o de gate aberto nem o do resumo (quem chama passa).
+        const codigo = (0, pulse_consentimento_1.gerarCodigo)([...Object.keys(notas), ...(opcoes.codigosEmUso ?? [])]);
+        const pedido = { contrato: exports.CONTRATO_PEDIDO_DE_NOTA, pedidoId: (0, node_crypto_1.randomUUID)(), thread, codigo, criadoEm: quando };
+        (0, ledger_1.registrar)((0, thread_1.dirThread)(raiz, thread), thread, ledger_1.TIPOS_DE_EVENTO.notaPedida, { fase: 'MASTER', pedidoId: pedido.pedidoId, codigo });
+        gravarNotas(raiz, { ...Object.fromEntries(Object.entries(notas).filter(([, n]) => n.thread !== thread)), [codigo]: pedido }, estadoDir);
+        return pedido;
+    });
+}
+/** A nota deste pedido ja foi dada pelo canal. */
+function notaDada(raiz, p) {
+    return (0, ledger_1.lerLedger)((0, thread_1.dirThread)(raiz, p.thread)).some(e => e.tipo === ledger_1.TIPOS_DE_EVENTO.masterConcluido &&
+        e.notaPedida?.pedidoId === p.pedidoId);
+}
+/** O pedido de nota que usa este codigo, quando ha um. */
+function pedidoDeNotaDoCodigo(raiz, codigo, estadoDir) {
+    try {
+        return lerNotas(raiz, estadoDir)[codigo.trim().toUpperCase()];
+    }
+    catch {
+        return undefined;
+    }
+}
+/** A linha que o canal mostra ao dono. Uma linha de contexto e uma de resposta. */
+function textoDoPedidoDeNota(raiz, p, canal) {
+    const t = (0, thread_1.lerThread)(raiz, p.thread);
+    const tg = canal === 'telegram';
+    return [
+        `${tg ? '🧾 ' : ''}Nota da entrega ${p.thread} (${t.nome.slice(0, 80)})`,
+        `${tg ? '• ' : '- '}Sem nota, vale a aceita por omissão, com o índice derivado do ledger ao lado.`,
+        `${tg ? '↩️ ' : ''}Responda: ${p.codigo} <0 a 5> <porquê>, por exemplo: ${p.codigo} 4 entregou o que pedi.`,
+    ].join('\n');
+}
+/** "4 entregou o que pedi" vira nota e justificativa; o resto e devolvido como pergunta. */
+function lerNota(resto) {
+    const m = /^\s*([0-5])(?:\s*\/\s*5)?\s*[-:,.]?\s+(\S[\s\S]{2,})$/.exec(resto);
+    return m ? { score: Number(m[1]), justificativa: m[2].trim() } : undefined;
+}
+/**
+ * O recibo que acompanha a nota no `master_done`. O envelope assinado inteiro fica guardado, para
+ * que a auditoria reconfira o HMAC do canal depois (`autenticarResposta` no instante recebido). Um
+ * arquivo por mensagem: a mesma mensagem nunca vira duas notas.
+ */
+function reciboDoCanal(raiz, envelope, vinculo, estadoDir) {
+    const dir = path.join(estadoDir ?? path.join((0, estado_thread_1.raizDoEstado)(raiz), '.orkastery', 'monitor'), 'master-nota');
+    fs.mkdirSync(dir, { recursive: true, mode: 0o700 });
+    const arquivo = path.join(dir, `${sha(envelope.mensagem)}.json`);
+    const corpo = JSON.stringify({ contrato: exports.CONTRATO_PEDIDO_DE_NOTA, vinculo, envelope }) + '\n';
+    if (!fs.existsSync(arquivo))
+        fs.writeFileSync(arquivo, corpo, { mode: 0o600, flag: 'wx' });
+    return {
+        origem: envelope.origem, canal: envelope.canal ?? null, conta: envelope.conta ?? null, mensagem: envelope.mensagem,
+        recebidoEm: envelope.recebidoEm, recibo: sha(envelope.prova), contratoResposta: envelope.canal === undefined ? 'ork.hitl-answer/v1' : 'ork.hitl-answer/v2',
+        evidencia: path.relative((0, estado_thread_1.raizDoEstado)(raiz), arquivo), evidenciaSha256: sha(fs.readFileSync(arquivo, 'utf8')), ...vinculo,
+    };
+}
+/** Mensagem ja usada numa nota desta thread nao vale de novo, igual ao gate. */
+function mensagemJaUsadaEmNota(raiz, thread, mensagem) {
+    return (0, ledger_1.lerLedger)((0, thread_1.dirThread)(raiz, thread)).some(e => e.tipo === ledger_1.TIPOS_DE_EVENTO.masterConcluido && e.mensagem === mensagem);
+}

package/dist/master.js

@@ -88,6 +88,7 @@ const horario_1 = require("./horario");
 const indice_1 = require("./indice");
 const ship_1 = require("./ship");
 const fabrica_publicar_1 = require("./fabrica-publicar");
+const fechamento_1 = require("./fechamento");
 /** Identificador do contrato congelado do MASTER log. */
 exports.CONTRATO_MASTER_LOG = 'ork.master-log/v1';
 /** Versao do contrato. Uma mudanca de contrato exige uma versao nova, nao um campo novo. */
@@ -392,7 +393,10 @@ function registrarMaster(raiz, id, opcoes) {
         classesDeFalha: masterLog.classesDeFalha, regime: postmortem.score.regime,
         contrato: exports.CONTRATO_MASTER_LOG, arquivo: path.relative((0, estado_thread_1.raizDoEstado)(raiz), r.caminhoMasterLog), estado: 'thread fechada',
         masterLogSha256: hashDocumento(r.caminhoMasterLog), postmortemSha256: hashDocumento(r.caminhoPostmortem),
+        ...(opcoes.prova ? { prova: 'ingresso-autenticado', ...opcoes.prova } : {}),
     });
+    // RM-037 (rm037noite): a thread fechada solta o que segurava, com registro no ledger dela.
+    (0, fechamento_1.liberarAoFechar)(raiz, id);
     return r;
 }
 exports.CONTRATO_MASTER_PENDENTE = 'ork.master-pending/v1';

package/dist/mcp-artifacts.js

@@ -157,6 +157,8 @@ function comEscrita(raiz, id, executar) {
             }
         }
         const nome = `path:.orkastery/threads/${id}`;
+        // RM-037 (fatia 3, defeito 4): lease e fila de thread fechada sao orfaos e saem antes da conferencia.
+        (0, leases_1.podarRegioesDeThreadsFechadas)(raiz, [nome], id);
         if ((0, leases_1.lerLease)(raiz, nome) || (0, leases_1.leasesColidentes)(raiz, nome).length)
             throw Error('lease.busy: estado canonico ocupado');
         const r = (0, leases_1.adquirirRegiao)(raiz, nome, { thread: id, motivo: 'MCP documento ou claim', ttlMs: 30000, retomarVencido: false });