@orkastery/cli 0.5.0 → 0.5.3

package/dist/indice-vetorial.js

@@ -56,13 +56,19 @@ exports.decodificarVetor = decodificarVetor;
 exports.lerIndice = lerIndice;
 exports.serializarIndice = serializarIndice;
 exports.gravarIndice = gravarIndice;
-exports.universoDoTenant = universoDoTenant;
+exports.conferirUniverso = conferirUniverso;
+exports.universoDaBusca = universoDaBusca;
+exports.codigoDaFalha = codigoDaFalha;
 exports.conteudoRecusado = conteudoRecusado;
+exports.indexavel = indexavel;
 exports.tokensEstimados = tokensEstimados;
 exports.dimDoModeloLocal = dimDoModeloLocal;
 exports.codigoDeEmbedding = codigoDeEmbedding;
 exports.espacoDoAlvo = espacoDoAlvo;
 exports.indexar = indexar;
+exports.avisoDeCobertura = avisoDeCobertura;
+exports.textoForaDaBusca = textoForaDaBusca;
+exports.textoDoIndice = textoDoIndice;
 exports.vetoresCoerentes = vetoresCoerentes;
 const fs = __importStar(require("node:fs"));
 const os = __importStar(require("node:os"));
@@ -170,18 +176,48 @@ function gravarIndice(arquivo, indice) {
     return true;
 }
 /**
- * Universo do tenant: o export governado das colecoes do ork (filtro de injecao e visibilidade
- * da biblioteca), com checagem EXPLICITA do tenant antes de qualquer texto ir ao embed.
+ * RM-038 (D6): a fronteira do universo no `ork`, num lugar so. Entrada de outro tenant, de colecao
+ * fora do ork ou com id repetido e violacao tipada, nunca descarte silencioso: nada disso vai ao embed.
  */
-function universoDoTenant(fonte, tenant, colecoes = orkmind_1.COLECOES_DO_ORK) {
-    return colecoes.flatMap(c => fonte.buscar({ collection: c, tags: { project: [tenant] } })
-        .filter(e => e.collection === c && (e.tags.project ?? []).includes(tenant)))
-        .sort((a, b) => a.collection.localeCompare(b.collection) || a.id.localeCompare(b.id));
+function conferirUniverso(entradas, tenant, lidoEm = Date.now()) {
+    const vistos = new Set();
+    for (const e of entradas) {
+        if (!(0, orkmind_1.pertenceAoUniverso)(e, tenant, lidoEm) || vistos.has(e.id))
+            throw new Error('memory.query.scope-violation');
+        vistos.add(e.id);
+    }
+}
+/**
+ * RM-038 (D4): o universo da busca e do indice, o domicilio unico. A fonte le uma vez (a ponte
+ * filtra o tenant na origem e aplica a governanca da biblioteca); aqui a fronteira e conferida de
+ * novo, a ordem fica estavel e a contagem por colecao sai pronta para o status e o index.
+ */
+function universoDaBusca(fonte, tenant) {
+    const lidoEm = Date.now();
+    const lido = fonte.universo(tenant);
+    conferirUniverso(lido.entradas, tenant, lidoEm);
+    const entradas = [...lido.entradas].sort((a, b) => a.collection.localeCompare(b.collection) || a.id.localeCompare(b.id));
+    const porColecao = Object.fromEntries(orkmind_1.COLECOES_DO_ORK.map(c => [c, 0]));
+    for (const e of entradas)
+        porColecao[e.collection] += 1;
+    return { tenant, lidoEm, entradas, porColecao, foraDaBusca: lido.foraDaBusca,
+        ...(lido.latenciaMs === undefined ? {} : { latenciaMs: lido.latenciaMs }) };
+}
+/** Codigo tipado de uma falha (`memory.query.window-saturated`), ou o padrao quando nao ha. */
+function codigoDaFalha(erro, padrao = 'memory.universo.indisponivel') {
+    return /^[a-z]+(?:\.[a-z-]+)+/.exec(erro instanceof Error ? erro.message : '')?.[0] ?? padrao;
 }
 /** Conteudo que nunca vai ao provider: padrao de segredo da policy ou URL com credencial. */
 function conteudoRecusado(conteudo) {
     return (0, policies_1.procurarSegredos)(conteudo).length > 0 || URL_COM_CREDENCIAL.test(conteudo);
 }
+/**
+ * RM-038: o indice embeda a entrada? Nao embeda texto vazio, acima do limite nem com padrao de
+ * segredo. Domicilio unico para o `indexar` e para o aviso de cobertura do status.
+ */
+function indexavel(e) {
+    return e.content.trim() !== '' && e.content.length <= orkmind_1.EMBED_MAX_CARACTERES && !conteudoRecusado(e.content);
+}
 function tokensEstimados(conteudo) {
     return Math.ceil(conteudo.length / exports.CARACTERES_POR_TOKEN);
 }
@@ -236,13 +272,20 @@ function espacoDoAlvo(config, alvo, env = process.env) {
  * que ja voltaram, porque cada vetor gravado e coerente por si.
  */
 function indexar(o) {
+    // RM-038 (D6): conferir de novo antes de qualquer coisa; nada de outro tenant vai ao embed, nem de
+    // um chamador que montou o universo a mao. Violacao falha alto, nunca vira descarte silencioso.
+    if (o.universo.tenant !== o.tenant)
+        throw new Error('memory.query.scope-violation');
+    conferirUniverso(o.universo.entradas, o.tenant, o.universo.lidoEm);
     const espaco = espacoDoAlvo(o.config, o.alvo, o.env);
-    const universo = o.universo.filter(e => (e.tags.project ?? []).includes(o.tenant));
+    const universo = o.universo.entradas;
     const foraDoLimite = universo.filter(e => e.content.length > orkmind_1.EMBED_MAX_CARACTERES);
     const recusados = universo.filter(e => e.content.length <= orkmind_1.EMBED_MAX_CARACTERES && conteudoRecusado(e.content));
-    const indexaveis = universo.filter(e => e.content.length <= orkmind_1.EMBED_MAX_CARACTERES && !conteudoRecusado(e.content) && e.content.trim());
+    const indexaveis = universo.filter(indexavel);
     const base = { alvo: o.alvo, modelo: null, dim: null, arquivo: null, dryRun: o.dryRun,
-        universo: universo.length, coerentes: 0, embedados: 0, reescritos: 0, removidos: 0, recusados: recusados.length,
+        universo: universo.length, porColecao: { ...o.universo.porColecao }, foraDaBusca: o.universo.foraDaBusca,
+        latenciaUniversoMs: o.universo.latenciaMs ?? null,
+        coerentes: 0, embedados: 0, reescritos: 0, removidos: 0, recusados: recusados.length,
         foraDoLimite: foraDoLimite.length, truncados: 0, tokensEstimados: 0, custoEstimadoUsd: 0, chamadasAoProvider: 0, motivo: null, detalhe: '' };
     if ('motivo' in espaco) {
         const tokens = indexaveis.reduce((t, e) => t + tokensEstimados(e.content), 0);
@@ -302,6 +345,40 @@ function indexar(o) {
         return { ...r, motivo, detalhe: `indexacao interrompida depois de ${r.embedados} vetor(es); os lotes concluidos ficaram gravados` };
     return r;
 }
+/**
+ * RM-038 (D7): o aviso de cobertura, o mesmo no status e na busca. Reindexar so e sugerido quando
+ * resolve; o que o indice nunca embeda (vazio, acima do limite, padrao de segredo) e dito a parte.
+ */
+function avisoDeCobertura(coerentes, entradas, alvo, onde = '') {
+    if (coerentes >= entradas.length)
+        return null;
+    const foraPorDesenho = entradas.filter(e => !indexavel(e)).length;
+    const base = `o indice cobre ${coerentes} de ${entradas.length} entrada(s) que a busca enxerga${onde}`;
+    if (coerentes < entradas.length - foraPorDesenho)
+        return `${base}: rode ork memory index${alvo === 'fallback' ? ' --modelo fallback' : ''}`;
+    return `${base}; ${foraPorDesenho} fica(m) fora do indice por desenho (vazia, acima de ${orkmind_1.EMBED_MAX_CARACTERES} caracteres ou com padrao de segredo)`;
+}
+/** RM-038: a linha do que fica fora da busca, a mesma no `ork memory index` e no `ork memory status`. */
+function textoForaDaBusca(f) {
+    return f ? `${f.injecao} com injection_risk e ${f.expiradas} expirada(s) (governanca da biblioteca), ` +
+        `${f.outrasColecoes} em outras colecoes (fora da busca do ork); nada disso vai ao embed` : 'nao medido nesta base';
+}
+/** Texto de `ork memory index`: de que universo, o que foi (ou seria) embedado e quanto custa estimado. */
+function textoDoIndice(r) {
+    const custo = r.custoEstimadoUsd === null ? 'nao estimado' : `US$ ${r.custoEstimadoUsd.toFixed(8)}`;
+    const colecoes = Object.entries(r.porColecao).map(([c, n]) => `${c} ${n}`).join(', ');
+    return [
+        `Indice vetorial (${r.alvo}${r.dryRun ? ', --dry-run' : ''}): ${r.modelo ?? '(sem modelo)'}${r.dim ? ` / ${r.dim} dim` : ''}`,
+        `  universo da busca    ${r.universo} entrada(s): ${colecoes}; coerentes ${r.coerentes}`,
+        `  fora da busca        ${textoForaDaBusca(r.foraDaBusca)}`,
+        `  embedados            ${r.embedados} (reescritos ${r.reescritos}); removidos ${r.removidos}`,
+        `  fora do indice       ${r.recusados} recusada(s) por padrao de segredo, ${r.foraDoLimite} acima do limite`,
+        ...(r.truncados ? [`  truncados            ${r.truncados} acima do contexto do modelo local, embedados pelo comeco`] : []),
+        `  estimativa           ${r.tokensEstimados} token(s), ${custo}; chamadas ao provider ${r.chamadasAoProvider}`,
+        ...(r.arquivo ? [`  arquivo              ${r.arquivo}`] : []),
+        ...(r.motivo ? [`  motivo               ${r.motivo}: ${r.detalhe}`] : r.detalhe ? [`  ${r.detalhe}`] : []),
+    ].join('\n');
+}
 /** Vetores coerentes de um indice para o universo informado: a base da busca e da cobertura. */
 function vetoresCoerentes(indice, universo) {
     const saida = new Map();

package/dist/indice.js

@@ -63,7 +63,9 @@ function calcularIndice(eventos) {
     const parcelas = [];
     let valor = exports.INDICE_BASE;
     for (const insumo of exports.INSUMOS_DO_INDICE) {
-        const ocorrencias = eventos.filter((e) => e.tipo === insumo.evento).length;
+        // Ensaio de 03/10/2026 (RM-049): o `ork ship --dry-run` barrado grava `ship_blocked` com `dryRun: true`;
+        // ensaio nao e tropeco da entrega, como ja nao e pausa no board (fatia 2 do ensaio da 0.5.0, P2).
+        const ocorrencias = eventos.filter((e) => e.tipo === insumo.evento && e.dryRun !== true).length;
         if (ocorrencias === 0)
             continue;
         const bruto = insumo.peso * ocorrencias;

package/dist/init.js

@@ -46,6 +46,7 @@ exports.baseBranchDetectada = baseBranchDetectada;
 exports.verifyDetectado = verifyDetectado;
 exports.detectar = detectar;
 exports.manifestoYaml = manifestoYaml;
+exports.exigirRepositorioParaInit = exigirRepositorioParaInit;
 exports.init = init;
 const fs = __importStar(require("node:fs"));
 const path = __importStar(require("node:path"));
@@ -68,7 +69,12 @@ function nomeDetectado(dirInicial) {
         : path.basename(raizDoRepo(dirInicial));
     return base.replace(/-(novo|new|old|repo|main)$/i, '').toLowerCase();
 }
-/** Branch base do repositorio: origin/HEAD, senao main, senao master, senao a atual. */
+/**
+ * Branch base do repositorio: origin/HEAD, senao main, senao master, senao a do HEAD.
+ * A do HEAD vem de `symbolic-ref`, que responde tambem no repositorio ainda sem commit (ensaio
+ * da 0.5.0: o `git init` sem `init.defaultBranch` nasce em `master`, e o `rev-parse` falhava e
+ * caia em `main`). HEAD destacado nao e branch: vale `main`.
+ */
 function baseBranchDetectada(raiz) {
     const origem = (0, util_1.exec)('git', ['symbolic-ref', '--quiet', 'refs/remotes/origin/HEAD'], raiz);
     if (origem.ok && origem.stdout.trim()) {
@@ -79,8 +85,7 @@ function baseBranchDetectada(raiz) {
             return candidata;
         }
     }
-    const atual = (0, util_1.exec)('git', ['rev-parse', '--abbrev-ref', 'HEAD'], raiz);
-    return atual.ok ? atual.stdout.trim() : 'main';
+    return (0, util_1.branchDoHead)(raiz) ?? 'main';
 }
 function gerenciadorDetectado(dir) {
     if (fs.existsSync(path.join(dir, 'pnpm-lock.yaml')))
@@ -188,6 +193,8 @@ conduction:
 worktree:
   base_branch: "${d.baseBranch}"
   dir: ".claude/worktrees"
+  # true: o ork thread new cria a worktree e a branch da thread sem flag (--sem-worktree cria sem);
+  # false ou ausente: só com --worktree auto
   por_thread: true
 
 verify:
@@ -255,6 +262,20 @@ policies:
   push_direto_na_base: block
 `;
 }
+/**
+ * Ensaio de 03/10/2026 (RM-049): o `ork init` rodado por engano fora de um repositorio (no HOME, por
+ * 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).
+ */
+function exigirRepositorioParaInit(dir) {
+    const r = (0, util_1.exec)('git', ['rev-parse', '--is-inside-work-tree'], dir);
+    if (r.ok && r.stdout.trim() === 'true')
+        return;
+    throw new Error(`init.fora-do-repositorio: ${path.resolve(dir)} não está num repositório git; nada foi criado. ` +
+        'Entre no repositório do projeto (ou crie um com git init e o primeiro commit) e rode ork init de novo.');
+}
 /** Gera o manifesto e o esqueleto de `.orkastery/`. Nao sobrescreve sem `force`. */
 function init(dirInicial, opcoes = {}) {
     const deteccao = detectar(dirInicial, opcoes.nome, opcoes.abbrev);
@@ -264,6 +285,8 @@ function init(dirInicial, opcoes = {}) {
         return { caminho, criado: false, deteccao };
     }
     (0, util_1.gravar)(caminho, manifestoYaml(deteccao));
-    fs.mkdirSync(path.join(deteccao.raiz, manifest_1.DIR_ESTADO, 'threads'), { recursive: true });
-    return { caminho, criado: true, deteccao };
+    const estado = path.join(deteccao.raiz, manifest_1.DIR_ESTADO);
+    fs.mkdirSync(path.join(estado, 'threads'), { recursive: true });
+    // Fatia 2 do ensaio da 0.5.0 (P3): o estado e da maquina; fica fora do git sem mexer no `.gitignore` do usuario.
+    return { caminho, criado: true, deteccao, estadoIgnorado: (0, util_1.ignorarPastaNoGit)(estado, deteccao.raiz) };
 }

package/dist/integracoes-locais.js

@@ -14,4 +14,8 @@ exports.TESTES_DE_INTEGRACAO_LOCAL = new Set([
     'mcp-git.test.js', 'mcp-server.test.js', 'mcp-ship.test.js', 'mcp-verify.test.js',
     'memory-native-preparation.test.js', 'memory-native-schema.test.js', 'memory-prospective.test.js',
     'memory-publication-profile.test.js', 'native-fixture.test.js', 'orkmind-transport.test.js', 'verify-sandbox.test.js',
+    // RM-037 (fatia 3): o worker do ork_git_commit e o sandbox do verify de verdade, como no mcp-git.test.js.
+    'rm037-fatia3-hard-link-mcp-git.test.js', 'rm037-fatia3-lease-mcp-git.test.js',
+    // RM-038 (fatia de correcao): a ponte com o GovernedStore real da biblioteca instalada.
+    'rm038-universo-ponte.test.js',
 ]);