@orkastery/cli 0.4.3 → 0.5.0

package/dist/ocupacao.js

@@ -25,6 +25,7 @@ exports.EVENTOS_QUE_DESTRAVAM = exports.PAUSA_PREVISTA = void 0;
 exports.ehAprovacaoHumana = ehAprovacaoHumana;
 exports.ehPausaPrevista = ehPausaPrevista;
 exports.faseTemPausaPrevista = faseTemPausaPrevista;
+exports.sessaoLivreDaVaga = sessaoLivreDaVaga;
 exports.avaliarOcupacao = avaliarOcupacao;
 const ledger_1 = require("./ledger");
 const sessoes_adopt_1 = require("./sessoes-adopt");
@@ -70,15 +71,50 @@ function ultimaSessao(thread, eventos) {
 /**
  * Carimbo do ultimo sinal de vida: o evento mais novo do ledger que seja TRABALHO da
  * thread. `slot_released` fica de fora: e contabilidade do escalonador, e se contasse
- * como atividade a thread stale rejuvenesceria no exato momento em que e expulsa.
+ * como atividade a thread stale rejuvenesceria no exato momento em que e expulsa. O
+ * `slot_refused` (RM-037) tambem: despacho recusado por vaga nao e trabalho.
  */
 function ultimaAtividadeEm(eventos) {
     for (let i = eventos.length - 1; i >= 0; i--) {
-        if (eventos[i].tipo !== ledger_1.TIPOS_DE_EVENTO.vagaLiberada)
+        const t = eventos[i].tipo;
+        if (t !== ledger_1.TIPOS_DE_EVENTO.vagaLiberada && t !== ledger_1.TIPOS_DE_EVENTO.vagaRecusada)
             return eventos[i].ts;
     }
     return null;
 }
+/**
+ * RM-037 (rm037defeito, defeito 3; achado N1 da rodada 2 do CHECK): a sessao com conducao VIVA que mesmo
+ * assim nao ocupa vaga do despacho. Sao tres: a parada (sem trabalho no ledger ha mais que `staleMin`,
+ * o mesmo teto do escalonador) e a que escalou para o humano depois de comecar (`gate_blocked`
+ * `human.pending` sem destravamento, ou sessao bloqueada no runtime), e a que o pulse declarou em silencio
+ * (`runtime.silencio`). A pausa PREVISTA ao fim do bloco nao entra: ela e gravada no proprio
+ * despacho e a sessao roda ate o fim do bloco. O impedimento de verify tambem nao: a sessao corrige e
+ * verifica de novo. Somente leitura.
+ */
+function sessaoLivreDaVaga(eventos, desde, agora, staleMin, 
+/** A-3 do CHECK 4: o bloqueio no runtime e por sessao; o de outra sessao (a sucedida) nao libera esta. */
+sessionId) {
+    const ultima = ultimaAtividadeEm(eventos);
+    if (ultima !== null && minutos(ultima, agora) >= staleMin)
+        return 'stale';
+    const inicio = Date.parse(desde);
+    const depois = eventos.filter((e) => Date.parse(e.ts) >= inicio);
+    // A-2 e S-7 do CHECK 3: o silencio que o pulse declarou (`runtime.silencio`) e a sessao bloqueada no runtime
+    // esperando o dono tambem nao executam; os dois saem da conta ate o evento que os resolve.
+    for (let i = depois.length - 1; i >= 0; i--) {
+        const e = depois[i];
+        if (e.tipo !== ledger_1.TIPOS_DE_EVENTO.gateBloqueado || (e.motivo !== 'human.pending' && e.motivo !== 'runtime.silencio'))
+            continue;
+        const resolvida = depois.slice(i + 1).some((p) => exports.EVENTOS_QUE_DESTRAVAM.includes(p.tipo) || ehAprovacaoHumana(p));
+        if (!resolvida)
+            return e.motivo;
+    }
+    const bloqueio = depois.filter((e) => (e.tipo === 'sessao_bloqueada' || e.tipo === 'sessao_destravada') &&
+        (!sessionId || e.sessionId === sessionId)).at(-1);
+    if (bloqueio?.tipo === 'sessao_bloqueada')
+        return 'human.pending';
+    return null;
+}
 /** A thread tem pausa humana ABERTA? Mesmas tres fontes do monitor, resumidas. */
 function pausaHumanaAberta(thread, eventos) {
     if (thread.status === 'pausada' && faseTemPausaPrevista(thread)) {

package/dist/onboarding.js

@@ -51,9 +51,11 @@ const project_state_1 = require("./project-state");
 const ledger_1 = require("./ledger");
 const policies_1 = require("./policies");
 const horario_1 = require("./horario");
+const experiencia_1 = require("./experiencia");
+const yaml_1 = require("./yaml");
 exports.CONTRATO_ONBOARDING = 'ork.onboarding/v1';
 exports.PAUTA_ONBOARDING = [
-    { etapa: 'maestro', pergunta: `Quem conduz o projeto, quais são seus objetivos e preferências, e em qual fuso horário o Orkastery deve mostrar horários? Informe o fuso como nome IANA, ex.: {"fuso":"${horario_1.FUSO_DE_BRASILIA}"}; ele orienta ${horario_1.CHAVE_DO_FUSO} no manifesto, sem editá-lo.` },
+    { etapa: 'maestro', pergunta: `Quem conduz o projeto, quais são seus objetivos e preferências, e em qual fuso horário o Orkastery deve mostrar horários? Informe o fuso como nome IANA, ex.: {"fuso":"${horario_1.FUSO_DE_BRASILIA}"}; ele orienta ${horario_1.CHAVE_DO_FUSO} no manifesto, sem editá-lo. Preferências em {"owner":{...}} gravam owner no manifesto.` },
     { etapa: 'credenciais', pergunta: 'Quais provedores públicos e nomes de variáveis em env serão usados? Segredos somente em ~/.hermes/.env; nunca informe valores.' },
     { etapa: 'bancos', pergunta: 'Quais bancos públicos e nomes de variáveis em env configuram as conexões? Nunca informe DSN ou senha; valores somente em ~/.hermes/.env.' },
     { etapa: 'memoria', pergunta: 'Deseja OrkMind? Informe {"modo":"orkmind"} ou {"modo":"files"}; a escolha orienta memory.mode no manifesto, sem editá-lo.' },
@@ -118,6 +120,16 @@ function validarConteudo(etapa, conteudo) {
     // I-35: o fuso do dono, quando informado, precisa ser um nome IANA que o Intl aceita.
     if (etapa === 'maestro' && objeto(conteudo) && Object.hasOwn(conteudo, 'fuso') && (0, horario_1.normalizarFuso)(conteudo.fuso) === undefined)
         invalido();
+    if (etapa === 'maestro' && objeto(conteudo) && Object.hasOwn(conteudo, 'owner')) {
+        if (!objeto(conteudo.owner) || Object.keys(conteudo.owner).some(k => !['language', 'timezone', 'depth', 'experience'].includes(k)))
+            invalido();
+        try {
+            (0, experiencia_1.validarPreferencias)(conteudo.owner);
+        }
+        catch {
+            invalido();
+        }
+    }
     // Etapas sensíveis usam um formato fechado: não há espaço para texto de credenciais.
     if (etapa === 'credenciais' || etapa === 'bancos') {
         if (!objeto(conteudo))
@@ -263,18 +275,109 @@ function comTrava(raiz, alterar) {
         fs.unlinkSync(trava);
     }
 }
+/** Comentário depois de valor simples ou entre aspas completas; `#` dentro das aspas é valor. */
+const COMENTARIO_NA_LINHA = /^\s*[^:#]+:\s*(?:"(?:[^"\\]|\\.)*"|'(?:[^']|'')*'|[^"'#\s][^#]*?)?(\s+#.*)$/;
+/** Altera somente as chaves públicas solicitadas, preservando comentários e outras seções. */
+function prepararPreferencias(raiz, conteudo) {
+    if (!objeto(conteudo) || !objeto(conteudo.owner) || !Object.keys(conteudo.owner).length)
+        return null;
+    const c = (0, manifest_1.exigirManifesto)((0, project_state_1.projectState)(raiz).root), arquivo = c.caminho;
+    const stat = fs.lstatSync(arquivo);
+    if (!stat.isFile() || stat.nlink !== 1)
+        throw Error('experiencia.manifesto.unsafe');
+    const anterior = fs.readFileSync(arquivo, 'utf8'), eol = anterior.includes('\r\n') ? '\r\n' : '\n';
+    const linhas = anterior.split(eol), ocorrencias = linhas.map((l, i) => /^(?:owner|"owner"|'owner')\s*:/.test(l) ? i : -1).filter(i => i >= 0);
+    if (ocorrencias.length > 1)
+        throw Error('experiencia.manifesto.conflict: owner duplicado');
+    let inicio = ocorrencias[0];
+    // Seção nova antes da quebra final, sem linha em branco sobrando nem perda do newline.
+    if (inicio === undefined) {
+        inicio = linhas.at(-1) === '' ? linhas.length - 1 : linhas.length;
+        linhas.splice(inicio, 0, 'owner:');
+    }
+    if (!/^(?:owner|"owner"|'owner')\s*:\s*(?:\{\}\s*)?(?:#.*)?$/.test(linhas[inicio]))
+        throw Error('experiencia.manifesto.conflict: owner não é mapa em bloco');
+    linhas[inicio] = linhas[inicio].replace('{}', '');
+    let fim = inicio + 1;
+    while (fim < linhas.length && !/^[^\s#][^:]*:/.test(linhas[fim]))
+        fim++;
+    for (const [k, v] of Object.entries((0, experiencia_1.validarPreferencias)(conteudo.owner))) {
+        const re = new RegExp('^  (?:' + k + '|"' + k + '"|\x27' + k + '\x27)\\s*:');
+        const indices = linhas.slice(inicio + 1, fim).map((l, i) => re.test(l) ? i + inicio + 1 : -1).filter(i => i >= 0);
+        if (indices.length > 1)
+            throw Error('experiencia.manifesto.conflict: preferência duplicada');
+        const linha = `  ${k}: ${JSON.stringify(v)}`;
+        // Comentário na mesma linha fica; a conferência semântica abaixo pega leitura errada.
+        if (indices.length)
+            linhas[indices[0]] = linha + (COMENTARIO_NA_LINHA.exec(linhas[indices[0]])?.[1] ?? '');
+        else {
+            linhas.splice(inicio + 1, 0, linha);
+            fim++;
+        }
+    }
+    const proximo = linhas.join(eol);
+    if (Buffer.byteLength(proximo) > manifest_1.LIMITE_MANIFESTO_BYTES)
+        throw Error('experiencia.manifesto.large');
+    // Sintaxes/indentações não representadas pelo editor não podem descartar dados do YAML.
+    const dados = (0, yaml_1.lerYaml)(anterior), novos = (0, yaml_1.lerYaml)(proximo);
+    if (!objeto(dados) || !objeto(novos))
+        throw Error('experiencia.manifesto.conflict');
+    const esperado = { ...dados, owner: { ...(objeto(dados.owner) ? dados.owner : {}), ...(0, experiencia_1.validarPreferencias)(conteudo.owner) } };
+    if (jsonCanonico(novos) !== jsonCanonico(esperado))
+        throw Error('experiencia.manifesto.conflict: edição perderia dados');
+    return { arquivo, anterior, proximo, modo: stat.mode };
+}
 function gravarEtapa(raiz, nome, conteudo, por = 'owner') {
     const etapa = exigirEtapa(nome);
     exigirAutor(por);
     validarConteudo(etapa, conteudo);
     return comTrava(raiz, () => {
+        const solicitadas = conteudo;
         const { estado } = lerParaMutacao(raiz), anterior = estado.etapas[etapa];
-        if (anterior && jsonCanonico(anterior.conteudo) === jsonCanonico(conteudo))
+        // Configurar preferências não apaga objetivos ou outras respostas da etapa maestro.
+        if (etapa === 'maestro' && objeto(conteudo) && objeto(conteudo.owner) && anterior && objeto(anterior.conteudo)) {
+            conteudo = { ...anterior.conteudo, ...conteudo, owner: {
+                    ...(objeto(anterior.conteudo.owner) ? anterior.conteudo.owner : {}), ...conteudo.owner,
+                } };
+            validarConteudo(etapa, conteudo);
+        }
+        validarConteudo(etapa, conteudo);
+        // Persistir só chaves deste pedido: uma resposta antiga não vence edição explícita do manifesto.
+        validarConteudo(etapa, solicitadas);
+        const preferencias = etapa === 'maestro' ? prepararPreferencias(raiz, solicitadas) : null;
+        const manifestoMuda = !!preferencias && preferencias.proximo !== preferencias.anterior;
+        const mesmaResposta = !!anterior && jsonCanonico(anterior.conteudo) === jsonCanonico(conteudo);
+        // Resposta igual com o manifesto editado à mão depois: o pedido explícito vale, e a entrevista
+        // guarda autoria e horário da resposta original.
+        if (mesmaResposta && !manifestoMuda)
             return estado;
-        const timestamp = new Date().toISOString();
-        estado.etapas[etapa] = { respondidaEm: timestamp, por, conteudo };
-        estado.atualizadoEm = dataMaisRecente([estado.atualizadoEm, timestamp]);
-        persistir(raiz, estado);
+        if (!mesmaResposta) {
+            const timestamp = new Date().toISOString();
+            estado.etapas[etapa] = { respondidaEm: timestamp, por, conteudo };
+            estado.atualizadoEm = dataMaisRecente([estado.atualizadoEm, timestamp]);
+        }
+        const salvarEstado = () => { if (!mesmaResposta)
+            persistir(raiz, estado); };
+        if (preferencias && manifestoMuda) {
+            const temporario = preferencias.arquivo + '.' + (0, node_crypto_1.randomUUID)() + '.tmp';
+            try {
+                fs.writeFileSync(temporario, preferencias.proximo, { flag: 'wx', mode: preferencias.modo });
+                fs.renameSync(temporario, preferencias.arquivo);
+                try {
+                    salvarEstado();
+                }
+                catch (e) {
+                    fs.writeFileSync(preferencias.arquivo, preferencias.anterior);
+                    throw e;
+                }
+            }
+            finally {
+                if (fs.existsSync(temporario))
+                    fs.unlinkSync(temporario);
+            }
+        }
+        else
+            salvarEstado();
         (0, ledger_1.registrar)((0, manifest_1.dirEstado)((0, project_state_1.projectState)(raiz).root), 'projeto', ledger_1.TIPOS_DE_EVENTO.onboardingRegistrado, { acao: 'set', etapa, por, sha256: sha(conteudo) });
         return estado;
     });
@@ -296,8 +399,11 @@ function resetarOnboarding(raiz, nome, por = 'owner') {
         return estado;
     });
 }
-function textoDaPauta(estado = onboardingPadrao()) {
+function textoDaPauta(estado = onboardingPadrao(), owner = {}) {
+    const p = (0, experiencia_1.resolverExperiencia)(owner);
     return ['Onboarding do projeto (' + exports.CONTRATO_ONBOARDING + ')',
+        `Experiência recomendada: ${p.language}, ${p.timezone}, resposta ${p.depth}. Ativar com esses valores, configurar ou desativar?`,
+        'Registre a escolha em maestro com {"owner":{"language":"' + p.language + '","timezone":"' + p.timezone + '","depth":"' + p.depth + '","experience":true}}; use experience:false para desativar. Consulta não registra resposta.',
         ...exports.PAUTA_ONBOARDING.map(({ etapa, pergunta }) => `${estado.etapas[etapa] ? '[respondida]' : '[pendente]'} ${etapa}: ${pergunta}`),
         'Responda com ork onboarding set <etapa> --conteudo <JSON> --por <quem>.'].join('\n');
 }

package/dist/orkmind.js

@@ -54,17 +54,22 @@ var __importStar = (this && this.__importStar) || (function () {
     };
 })();
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.DriverEmMemoria = exports.DriverCliOrkMind = exports.LIMITE_CONSULTA_MAXIMO = exports.LIMITE_CONSULTA_PADRAO = exports.ESQUEMA_ORKMIND = exports.DIMENSOES = exports.COLECOES_DE_GOVERNANCA = exports.COLECOES_DO_ORK = void 0;
+exports.DriverEmMemoria = exports.DriverCliOrkMind = exports.LIMITE_CONSULTA_MAXIMO = exports.LIMITE_CONSULTA_PADRAO = exports.CODIGOS_DE_EMBEDDING = exports.MODELO_DE_EMBEDDING = exports.EMBED_MAX_CARACTERES = exports.EMBED_MAX_TEXTOS = exports.ESQUEMA_ORKMIND = exports.DIMENSOES = exports.COLECOES_DE_GOVERNANCA = exports.COLECOES_DO_ORK = void 0;
 exports.enderecoDeMemoria = enderecoDeMemoria;
 exports.lerEndereco = lerEndereco;
 exports.violacoesDeGovernanca = violacoesDeGovernanca;
 exports.casaTags = casaTags;
+exports.textoDeBuscaValido = textoDeBuscaValido;
+exports.chaveDeEmbeddingAceita = chaveDeEmbeddingAceita;
+exports.validarPedidoDeEmbedding = validarPedidoDeEmbedding;
+exports.conferirRespostaDeEmbedding = conferirRespostaDeEmbedding;
 exports.criarEscopoDeLeitura = criarEscopoDeLeitura;
 exports.validarConsultaDelimitada = validarConsultaDelimitada;
 exports.tagsDoEscopo = tagsDoEscopo;
 exports.pertenceAoEscopo = pertenceAoEscopo;
 exports.concluirConsultaDelimitada = concluirConsultaDelimitada;
 exports.entradaDoJson = entradaDoJson;
+exports.vetorDeDuble = vetorDeDuble;
 exports.camposNativos = camposNativos;
 exports.agenteProspectivoValido = agenteProspectivoValido;
 exports.prospectivaCompativel = prospectivaCompativel;
@@ -180,6 +185,66 @@ function casaTags(entrada, consulta) {
     }
     return todasCasaram || (entrada.mandatory && algumaCasou);
 }
+/** Texto de busca: nao vazio, sem caractere de controle, ate 2.000 caracteres. */
+function textoDeBuscaValido(texto) {
+    return typeof texto === 'string' && texto.trim() !== '' && texto.length <= 2000 && !/[\x00-\x1f\x7f]/.test(texto);
+}
+/** Limites da operacao `embed` (D10): lote e tamanho de texto, sem truncar em silencio. */
+exports.EMBED_MAX_TEXTOS = 32;
+exports.EMBED_MAX_CARACTERES = 24_000;
+/** Domicilio unico do formato `org/nome` de modelo de embedding (primario e fallback). */
+exports.MODELO_DE_EMBEDDING = /^[A-Za-z0-9][A-Za-z0-9._-]*\/[A-Za-z0-9][A-Za-z0-9._-]*$/;
+/**
+ * O valor lido da variavel declarada so vale como chave se nao parecer outra coisa: URL, DSN,
+ * texto com espaco ou a propria DSN da memoria nunca vao ao provider (nome trocado por engano).
+ */
+function chaveDeEmbeddingAceita(valor, dsn) {
+    if (valor === '' || /\s/.test(valor) || valor.includes('://') || valor === dsn.trim())
+        return false;
+    // A senha da DSN sozinha tambem nunca vai ao provider como Bearer.
+    try {
+        const senha = new URL(dsn).password;
+        if (senha && (valor === senha || valor === decodeURIComponent(senha)))
+            return false;
+    }
+    catch { /* DSN opaca (key=value): a comparacao inteira acima ja vale */ }
+    return true;
+}
+/** Codigos tipados que a ponte pode devolver na operacao `embed`. */
+exports.CODIGOS_DE_EMBEDDING = [
+    'memory.embed.invalid', 'embeddings.chave-ausente', 'embeddings.provider-indisponivel', 'embeddings.timeout',
+    'embeddings.local-ausente', 'embeddings.dependencia-ausente', 'embeddings.dimensao-divergente',
+    'embeddings.conteudo-recusado',
+];
+/** Copia validada: o que vai a ponte e exatamente o que foi conferido aqui. */
+function validarPedidoDeEmbedding(bruto) {
+    const p = bruto;
+    if (!objetoDeConsulta(p) || Object.keys(p).some(k => !['papel', 'alvo', 'modelo', 'dim', 'textos'].includes(k)) ||
+        !['consulta', 'documento'].includes(p.papel) || !['primario', 'fallback'].includes(p.alvo) ||
+        typeof p.modelo !== 'string' || !exports.MODELO_DE_EMBEDDING.test(p.modelo) ||
+        !Number.isInteger(p.dim) || Number(p.dim) < 32 || Number(p.dim) > 4096 ||
+        !Array.isArray(p.textos) || p.textos.length < 1 || p.textos.length > exports.EMBED_MAX_TEXTOS ||
+        !p.textos.every(t => typeof t === 'string' && t.trim() !== '' && t.length <= exports.EMBED_MAX_CARACTERES)) {
+        throw new Error('memory.embed.invalid');
+    }
+    return { papel: p.papel, alvo: p.alvo,
+        modelo: p.modelo, dim: Number(p.dim), textos: [...p.textos] };
+}
+/** Resposta da ponte conferida: um vetor finito por texto, todos na dimensao pedida. */
+function conferirRespostaDeEmbedding(r, pedido) {
+    const o = r;
+    if (!objetoDeConsulta(o) || o.alvo !== pedido.alvo || o.modelo !== pedido.modelo || o.dim !== pedido.dim ||
+        !Array.isArray(o.vetores))
+        throw new Error('memory.transport.embed');
+    if (o.vetores.length !== pedido.textos.length || !o.vetores.every(v => Array.isArray(v) && v.length === pedido.dim &&
+        v.every(x => typeof x === 'number' && Number.isFinite(x))))
+        throw new Error('embeddings.dimensao-divergente');
+    const truncados = o.truncados === undefined ? [] : o.truncados;
+    if (!Array.isArray(truncados) || !truncados.every(i => Number.isInteger(i) && i >= 0 && i < pedido.textos.length)) {
+        throw new Error('memory.transport.embed');
+    }
+    return { alvo: pedido.alvo, modelo: pedido.modelo, dim: pedido.dim, vetores: o.vetores, truncados: truncados };
+}
 exports.LIMITE_CONSULTA_PADRAO = 100;
 exports.LIMITE_CONSULTA_MAXIMO = 1000;
 function objetoDeConsulta(x) {
@@ -314,9 +379,19 @@ class DriverCliOrkMind {
             throw new Error('memory.transport.interpreter: shebang nao suportado');
         return match[2] ? [match[1], match[2]] : [match[1]];
     }
+    /** Valor da chave de embedding no ambiente do `ork`; nunca guardado no driver. */
+    chaveDeEmbedding() {
+        const nome = this.config.variavelDaChaveDeEmbedding ?? '';
+        const valor = nome ? (process.env[nome] ?? '').trim() : '';
+        return chaveDeEmbeddingAceita(valor, this.config.dsn) ? valor : '';
+    }
     contemSegredo(valor) {
         const segredo = this.config.dsn;
         const proibidos = [segredo];
+        const nome = this.config.variavelDaChaveDeEmbedding ?? '';
+        const chave = nome ? (process.env[nome] ?? '').trim() : '';
+        if (chave.length >= 12)
+            proibidos.push(chave);
         try {
             const senha = new URL(segredo).password;
             if (senha.length >= 12)
@@ -328,7 +403,7 @@ class DriverCliOrkMind {
             : !!x && typeof x === 'object' && Object.entries(x).some(([k, v]) => examinar(k) || examinar(v));
         return examinar(valor);
     }
-    rodar(pedido) {
+    rodar(pedido, timeoutMs = this.config.timeoutMs) {
         if (!this.config.dsn.trim())
             throw new Error('dsn.env-ausente');
         if (this.contemSegredo(pedido))
@@ -338,13 +413,19 @@ class DriverCliOrkMind {
             path.join(__dirname, '../../assets/orkmind_bridge.py')].find(p => fs.existsSync(p));
         if (!ponte)
             throw new Error('memory.transport.bridge: ponte ausente no pacote');
-        const env = { ORKMIND_DATABASE_URL: this.config.dsn, PYTHONDONTWRITEBYTECODE: '1' };
-        for (const nome of ['PATH', 'HOME', 'LANG', 'LC_ALL', 'SYSTEMROOT']) {
+        // I-38 (D1): `embed` nao toca a base, entao nao recebe a DSN; a chave vai SO ao `embed` primario.
+        const embed = pedido.op === 'embed';
+        const env = embed ? { PYTHONDONTWRITEBYTECODE: '1' }
+            : { ORKMIND_DATABASE_URL: this.config.dsn, PYTHONDONTWRITEBYTECODE: '1' };
+        for (const nome of ['PATH', 'HOME', 'LANG', 'LC_ALL', 'SYSTEMROOT', 'HF_HOME', 'HF_HUB_CACHE']) {
             if (process.env[nome])
                 env[nome] = process.env[nome];
         }
+        const chave = embed && pedido.alvo === 'primario' ? this.chaveDeEmbedding() : '';
+        if (chave)
+            env.ORKMIND_EMBEDDING_API_KEY = chave;
         const r = (0, node_child_process_1.spawnSync)(python, [...prefixo, ponte], {
-            encoding: 'utf8', input: JSON.stringify(pedido), timeout: this.config.timeoutMs,
+            encoding: 'utf8', input: JSON.stringify(pedido), timeout: timeoutMs,
             maxBuffer: 32 * 1024 * 1024, env,
         });
         // Nunca reutilizar stdout, stderr, error.message ou causa de uma falha do filho.
@@ -359,7 +440,7 @@ class DriverCliOrkMind {
                 code = JSON.parse(r.stdout)?.error;
             }
             catch { /* nenhum detalhe do filho */ }
-            throw new Error(['memory.schema.absent', 'memory.legacy.provenance-collision', 'memory.prospective.marker-invalid', 'memory.native.schema-mismatch', 'memory.query.invalid', 'memory.query.window-saturated', 'memory.query.scope-violation'].includes(code) ? code : 'memory.transport.failed');
+            throw new Error(['memory.schema.absent', 'memory.legacy.provenance-collision', 'memory.prospective.marker-invalid', 'memory.native.schema-mismatch', 'memory.query.invalid', 'memory.query.window-saturated', 'memory.query.scope-violation', 'memory.health.invalid', 'memory.fts.invalid', ...exports.CODIGOS_DE_EMBEDDING].includes(code) ? code : 'memory.transport.failed');
         }
         let json;
         try {
@@ -372,18 +453,33 @@ class DriverCliOrkMind {
             throw new Error('memory.transport.secret: resposta recusada');
         return json;
     }
+    /** O detalhe sai do que a operacao `health` observou, nunca de frase fixa (I-38 T4). */
     disponivel() {
         if (this.saude)
             return this.saude;
         try {
-            this.contagens();
-            this.saude = { ok: true, detalhe: 'ponte OrkMind respondeu; embeddings desativados' };
+            const saude = this.sondarSaude();
+            const total = Object.values(saude.contagens).reduce((a, b) => a + b, 0);
+            this.saude = { ok: true, saude, detalhe: `ponte OrkMind respondeu a sonda health (orkmind ${saude.orkmind ?? 'sem versao declarada'}, ` +
+                    `${total} entrada(s) em ${Object.keys(saude.contagens).length} colecao(oes))` };
         }
         catch (e) {
             this.saude = { ok: false, detalhe: e.message };
         }
         return this.saude;
     }
+    sondarSaude() {
+        const r = this.rodar({ op: 'health' });
+        const contagens = r?.contagens;
+        const fallback = r?.fallback;
+        if (!objetoDeConsulta(r) || !objetoDeConsulta(contagens) || !objetoDeConsulta(fallback) ||
+            !Object.values(contagens).every(v => Number.isInteger(v) && Number(v) >= 0) ||
+            typeof fallback.dependencias !== 'boolean' || !(r.orkmind === null || typeof r.orkmind === 'string')) {
+            throw new Error('memory.transport.health');
+        }
+        return { contagens: contagens, orkmind: r.orkmind,
+            fallback: { dependencias: fallback.dependencias } };
+    }
     contagens() {
         const r = this.rodar({ op: 'stats' });
         if (!r || Array.isArray(r) || typeof r !== 'object' ||
@@ -444,6 +540,21 @@ class DriverCliOrkMind {
             throw new Error('memory.transport.readback');
         return e;
     }
+    embeddar(pedido, opcoes = {}) {
+        const p = validarPedidoDeEmbedding(pedido);
+        if (p.alvo === 'primario' && !this.chaveDeEmbedding())
+            throw new Error('embeddings.chave-ausente');
+        return conferirRespostaDeEmbedding(this.rodar({ op: 'embed', ...p }, opcoes.timeoutMs), p);
+    }
+    buscarTexto(tenant, texto) {
+        if (!textoDeConsulta(tenant, 128) || !textoDeBuscaValido(texto))
+            throw new Error('memory.fts.invalid');
+        const r = this.rodar({ op: 'fts', tenant, texto });
+        if (!objetoDeConsulta(r) || !Array.isArray(r.ids) || !r.ids.every(id => typeof id === 'string' && id)) {
+            throw new Error('memory.transport.fts');
+        }
+        return r.ids;
+    }
     submeterHandoff(pedido) {
         try {
             const r = this.rodar({ op: 'handoff', pedido });
@@ -458,6 +569,15 @@ class DriverCliOrkMind {
     }
 }
 exports.DriverCliOrkMind = DriverCliOrkMind;
+/** Vetor do dublê: cada palavra soma 1 numa posicao por hash; normalizado. Deterministico. */
+function vetorDeDuble(texto, dim) {
+    const v = new Array(dim).fill(0);
+    const palavras = texto.normalize('NFD').replace(/[\u0300-\u036f]/g, '').toLowerCase().match(/[a-z0-9]+/g) ?? [];
+    for (const palavra of palavras)
+        v[(0, node_crypto_1.createHash)('sha256').update(palavra).digest().readUInt32BE(0) % dim] += 1;
+    const norma = Math.hypot(...v);
+    return norma === 0 ? v.map((_, i) => (i === 0 ? 1 : 0)) : v.map(x => x / norma);
+}
 function tagsFixasDaDecisao(tags) {
     const fases = new Set(['GOAL', 'PLAN', 'GO', 'CHECK', 'SHIP', 'MASTER']);
     return Object.fromEntries(Object.entries(tags).filter(([k]) => k !== 'agent').map(([k, values]) => [k, [...new Set(values.filter(v => !(k === 'skill' && fases.has(v)) &&
@@ -547,6 +667,10 @@ class DriverEmMemoria {
     contador = 0;
     /** Quando false, o driver se declara indisponivel: e o teste de degradacao. */
     ligado = true;
+    /** I-38: quais alvos de embedding o dublê atende; o resto responde com o motivo tipado. */
+    embedding = { primario: true, fallback: true };
+    /** Pedidos de embedding recebidos, para as assercoes de custo (chamadas ao provider). */
+    pedidosDeEmbedding = [];
     constructor(entradas = []) {
         for (const e of entradas)
             this.entradas.push(e);
@@ -554,7 +678,8 @@ class DriverEmMemoria {
     }
     disponivel() {
         return this.ligado
-            ? { ok: true, detalhe: `driver em memoria com ${this.entradas.length} entrada(s)` }
+            ? { ok: true, detalhe: `driver em memoria com ${this.entradas.length} entrada(s)`,
+                saude: { contagens: this.contagens(), orkmind: null, fallback: { dependencias: this.embedding.fallback } } }
             : { ok: false, detalhe: 'driver em memoria desligado' };
     }
     adicionar(entrada) {
@@ -664,6 +789,35 @@ class DriverEmMemoria {
         return { ok: true, id: handoff.id, duplicada: false, collection: 'handoff', detalhe: 'duplo de transporte G3',
             session_entry_id: sessao.id, package_entry_id: pacote.id, package_id: packageId, readback: true };
     }
+    /**
+     * Dublê declarado de embedding: saco de palavras com hash, sem semantica nenhuma. Serve para
+     * provar contrato (dimensao, tenant, idempotencia, custo) sem rede e sem modelo.
+     */
+    embeddar(pedido) {
+        const p = validarPedidoDeEmbedding(pedido);
+        if (!this.ligado)
+            throw new Error('memory.transport.unavailable');
+        if (!this.embedding[p.alvo])
+            throw new Error(p.alvo === 'primario' ? 'embeddings.chave-ausente' : 'embeddings.local-ausente');
+        this.pedidosDeEmbedding.push(p);
+        return { alvo: p.alvo, modelo: p.modelo, dim: p.dim, vetores: p.textos.map(t => vetorDeDuble(t, p.dim)) };
+    }
+    /** Dublê de FTS: todas as palavras da consulta no conteudo, sem stemming, com tenant obrigatorio. */
+    buscarTexto(tenant, texto) {
+        if (!textoDeConsulta(tenant, 128) || !textoDeBuscaValido(texto))
+            throw new Error('memory.fts.invalid');
+        if (!this.ligado)
+            throw new Error('memory.transport.unavailable');
+        const palavras = (t) => t.normalize('NFD').replace(/[\u0300-\u036f]/g, '').toLowerCase().match(/[a-z0-9]+/g) ?? [];
+        const consulta = palavras(texto);
+        return this.entradas
+            .filter(e => exports.COLECOES_DO_ORK.includes(e.collection) && (e.tags.project ?? []).includes(tenant))
+            .map(e => ({ id: e.id, conteudo: palavras(e.content) }))
+            .filter(e => consulta.every(p => e.conteudo.includes(p)))
+            .map(e => ({ id: e.id, peso: e.conteudo.filter(p => consulta.includes(p)).length }))
+            .sort((a, b) => b.peso - a.peso || a.id.localeCompare(b.id))
+            .map(e => e.id);
+    }
     /** So para os testes: injeta uma entrada que o `ork` nunca gravaria (humano, mandatory). */
     semear(entrada) {
         this.entradas.push(entrada);
@@ -685,6 +839,8 @@ function configDoManifesto(manifesto) {
         dsn: variavel ? (process.env[variavel] ?? '') : '',
         timeoutMs: manifesto.memory.timeout_ms || 15000,
         tenant: manifesto.memory.tenant || manifesto.project.name,
+        // Lido direto do bloco: este modulo carrega sem o parser do manifesto (memory-native-schema).
+        variavelDaChaveDeEmbedding: manifesto.memory.embedding?.provider === 'openrouter' ? manifesto.memory.embedding.api_key_env : '',
     };
 }
 /** Texto acionavel para cada motivo de degradacao. */