@orkastery/cli 0.5.1 → 0.5.6

package/dist/company-brain-context.js

@@ -1,12 +1,15 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.CONTEXT_SCHEMA = void 0;
+exports.SERVER_CONTEXT_SCHEMA = exports.CONTEXT_SCHEMA = void 0;
 exports.buildContext = buildContext;
 const portfolio_1 = require("./portfolio");
 const company_brain_client_1 = require("./company-brain-client");
 const company_brain_contract_1 = require("./company-brain-contract");
 const company_brain_source_1 = require("./company-brain-source");
 exports.CONTEXT_SCHEMA = 'ork.brain-context/v1';
+exports.SERVER_CONTEXT_SCHEMA = 'orkmind.company-brain-context/v1';
+const SEM_MODO_CONTEXT = 'brain.selection.context-unsupported';
+const SERVIDOR_INVALIDO = 'brain.context.server-invalid';
 const ID = /^(prod|proj|init)-[a-z0-9][a-z0-9-]{2,47}$/;
 const ORDEM = { prod: 0, proj: 1, init: 2 };
 const LIMITE = 1000;
@@ -27,25 +30,122 @@ function citacaoDe(source) {
         return null;
     return { instance, source_ref, source_hash, source_version, location };
 }
+/** O servidor exige também `authority`: o pacote dele só traz item com a citação inteira; a consulta exige o mesmo. */
+const citadoPeloServidor = (source) => citacaoDe(source) !== null && typeof source.authority === 'string' && source.authority !== '';
 /**
- * Monta o pacote dos ids pedidos mais a cadeia de pais. A fonte canônica é o portfólio local;
- * o Brain é projeção, e a diferença entre os dois sai como frescor e lacuna, nunca é corrigida aqui.
+ * Confere um pacote `orkmind.company-brain-context/v1` contra o lote pedido: schema, tenant, pedido,
+ * digest recalculado, citação inteira, ordem, fecho de pais e destino de cada id pedido.
  */
-function buildContext(c, ids, transport, thread) {
-    const tenant = c.manifesto.memory.tenant;
-    const pedido = [...new Set(ids)].sort(comparar);
-    if (!pedido.length)
-        throw Error('brain.context.ids-required');
-    if (pedido.some(id => !ID.test(id)))
-        throw Error('brain.context.id-invalid');
-    if (pedido.length > LIMITE)
-        throw Error('brain.context.too-many');
-    const fonte = new Map((0, company_brain_source_1.portfolioEntities)((0, portfolio_1.readPortfolio)(c.raiz), { tenant, instance: c.manifesto.project.name, thread, aclRef: 'ork-factory' }).map(e => [e.id, e]));
-    const base = { schema: exports.CONTEXT_SCHEMA, tenant, contrato: company_brain_contract_1.CONTRACT_HASH, thread, pedido };
-    const encerrar = (r) => ({ ...base, state: r.state, ...(r.error ? { error: r.error } : {}), itens: [], lacunas: [], digest: null, consultadoEm: new Date().toISOString() });
+function conferirPacoteDoServidor(r, tenant, lote) {
+    const ctx = r.context;
+    if (!['ok', 'empty'].includes(r.state) || !ctx || typeof ctx !== 'object' || Array.isArray(ctx))
+        return false;
+    if (Object.keys(ctx).sort().join(',') !== 'digest,gaps,items,requested,schema,tenant_id')
+        return false;
+    const { digest: recebido, ...corpo } = ctx;
+    if (ctx.schema !== exports.SERVER_CONTEXT_SCHEMA || ctx.tenant_id !== tenant || (0, company_brain_contract_1.canonical)(ctx.requested) !== (0, company_brain_contract_1.canonical)(lote) ||
+        !Array.isArray(ctx.items) || !Array.isArray(ctx.gaps) || typeof recebido !== 'string' || (0, company_brain_contract_1.digest)(corpo) !== recebido)
+        return false;
+    if (r.state !== (ctx.items.length ? 'ok' : 'empty'))
+        return false;
+    const pedidos = new Set(lote), vistos = new Map(), codigos = new Map();
+    for (const g of ctx.gaps) {
+        if (!g || typeof g.id !== 'string' || typeof g.code !== 'string' || !ID.test(g.id))
+            return false;
+        if (!codigos.has(g.id))
+            codigos.set(g.id, new Set());
+        codigos.get(g.id).add(g.code);
+    }
+    for (const item of ctx.items) {
+        if (!item || typeof item.id !== 'string' || !ID.test(item.id) || vistos.has(item.id))
+            return false;
+        if (item.state === 'withheld') {
+            if (Object.keys(item).length !== 2)
+                return false;
+        }
+        else if (item.state !== 'ok' || !item.entity || typeof item.entity !== 'object' || item.entity.kind !== kindDe(item.id) ||
+            !Number.isInteger(item.entity.version) || !citadoPeloServidor(item.entity.source))
+            return false;
+        vistos.set(item.id, item);
+    }
+    const ordem = ctx.items.map((i) => i.id);
+    const ordenado = [...ordem].sort((a, b) => ORDEM[kindDe(a)] - ORDEM[kindDe(b)] || comparar(a, b));
+    if ((0, company_brain_contract_1.canonical)(ordem) !== (0, company_brain_contract_1.canonical)(ordenado))
+        return false;
+    // Fecho: todo item fora do pedido é pai, um kind acima, de um item citado do pacote.
+    const paisCitados = new Set();
+    for (const item of ctx.items)
+        if (item.state === 'ok') {
+            const parent = item.entity.parent_id;
+            if (typeof parent === 'string' && ID.test(parent) && ORDEM[kindDe(parent)] < ORDEM[kindDe(item.id)])
+                paisCitados.add(parent);
+        }
+    for (const id of vistos.keys())
+        if (!pedidos.has(id) && !paisCitados.has(id))
+            return false;
+    // Destino: todo id pedido sai como item ou como lacuna de desconhecido ou de citação incompleta.
+    for (const id of lote) {
+        const c = codigos.get(id);
+        if (!vistos.has(id) && !(c?.has('entity.unknown') || c?.has('citation.incomplete')))
+            return false;
+        if (vistos.has(id) && (c?.has('entity.unknown') || c?.has('citation.incomplete')))
+            return false;
+    }
+    return true;
+}
+/**
+ * B4.2: resolve o escopo pelo modo `context` do servidor. Devolve null quando o OrkMind não tem o modo
+ * (o chamador usa a consulta), ou a resposta que encerra o pacote.
+ */
+function resolverPeloServidor(transport, tenant, pedido, fonte, pai) {
+    const escopo = new Set(pedido), brain = new Map(), retidos = new Set(), semCitacao = new Set();
+    let primeiro = true;
+    for (let pendentes = pedido; pendentes.length;) {
+        const resolvidosNaVolta = [];
+        for (let inicio = 0; inicio < pendentes.length; inicio += LIMITE) {
+            const lote = pendentes.slice(inicio, inicio + LIMITE);
+            const r = transport({ schema: company_brain_client_1.BRAIN_API, operation: 'query', payload: (0, company_brain_contract_1.validateContract)({ schema: 'orkmind.company-brain-selection/v1',
+                    tenant_id: tenant, facets: { ids: lote, kinds: [], workspace_ids: [], source_instances: [] }, mode: 'context',
+                    limit: lote.length, offset: 0 }) });
+            if (r.state === 'unavailable' && r.error === SEM_MODO_CONTEXT)
+                return primeiro ? null : { state: 'conflict', error: SERVIDOR_INVALIDO };
+            primeiro = false;
+            if (falha(r.state))
+                return r;
+            if (!conferirPacoteDoServidor(r, tenant, lote))
+                return { state: 'conflict', error: SERVIDOR_INVALIDO };
+            const ctx = r.context;
+            for (const g of ctx.gaps)
+                if (g.code === 'citation.incomplete')
+                    semCitacao.add(g.id);
+            for (const item of ctx.items) {
+                // Pai que outro lote ou volta já resolveu vale uma vez só: a primeira resposta fica.
+                if (escopo.has(item.id) && !lote.includes(item.id))
+                    continue;
+                escopo.add(item.id);
+                resolvidosNaVolta.push(item.id);
+                if (item.state === 'withheld')
+                    retidos.add(item.id);
+                else
+                    brain.set(item.id, { ...item.entity, id: item.id });
+            }
+            resolvidosNaVolta.push(...lote);
+        }
+        // O servidor fecha os pais que o Brain conhece; os que só a fonte local conhece vão na próxima volta.
+        const novos = new Set();
+        for (const id of resolvidosNaVolta)
+            if (!retidos.has(id))
+                for (const parent of [pai(id, fonte.get(id)?.parent_id), pai(id, brain.get(id)?.parent_id)])
+                    if (parent && !escopo.has(parent))
+                        novos.add(parent);
+        novos.forEach(id => escopo.add(id));
+        pendentes = [...novos].sort(comparar);
+    }
+    return { brain, retidos, semCitacao, escopo };
+}
+/** B4.1: o caminho anterior ao modo `context`, por `query` e `get`, para um OrkMind sem o modo. */
+function resolverPelaConsulta(transport, tenant, pedido, fonte, pai) {
     const escopo = new Set(pedido), brain = new Map(), retidos = new Set();
-    // O pai só entra por um filho visível e tem kind acima dele: init, proj e prod fecham em três voltas.
-    const pai = (id, parent) => typeof parent === 'string' && ID.test(parent) && ORDEM[kindDe(parent)] < ORDEM[kindDe(id)] ? parent : null;
     let gets = 0;
     for (let pendentes = pedido; pendentes.length;) {
         for (let inicio = 0; inicio < pendentes.length; inicio += LIMITE) {
@@ -54,7 +154,7 @@ function buildContext(c, ids, transport, thread) {
                     tenant_id: tenant, facets: { ids: lote, kinds: [], workspace_ids: [], source_instances: [] }, mode: 'selection',
                     limit: lote.length, offset: 0 }) });
             if (falha(r.state))
-                return encerrar(r);
+                return r;
             const itens = Array.isArray(r.items) ? r.items : [];
             for (const item of itens)
                 if (item?.state === 'ok' && doLote.has(item.entity?.id))
@@ -67,10 +167,10 @@ function buildContext(c, ids, transport, thread) {
             else if (retidosNoLote)
                 for (const id of faltantes) {
                     if (++gets > LIMITE_DE_GET)
-                        return encerrar({ state: 'unavailable', error: 'brain.context.get-limit' });
+                        return { state: 'unavailable', error: 'brain.context.get-limit' };
                     const g = transport({ schema: company_brain_client_1.BRAIN_API, operation: 'get', payload: { tenant_id: tenant, id } });
                     if (falha(g.state))
-                        return encerrar(g);
+                        return g;
                     if (g.state === 'withheld')
                         retidos.add(id);
                     else if (g.state === 'ok' && g.entity?.id === id)
@@ -87,6 +187,35 @@ function buildContext(c, ids, transport, thread) {
                     }
         pendentes = novos.sort(comparar);
     }
+    return { brain, retidos, semCitacao: new Set(), escopo };
+}
+/**
+ * Monta o pacote dos ids pedidos mais a cadeia de pais. A fonte canônica é o portfólio local;
+ * o Brain é projeção, e a diferença entre os dois sai como frescor e lacuna, nunca é corrigida aqui.
+ */
+function buildContext(c, ids, transport, thread) {
+    const tenant = c.manifesto.memory.tenant;
+    const pedido = [...new Set(ids)].sort(comparar);
+    if (!pedido.length)
+        throw Error('brain.context.ids-required');
+    if (pedido.some(id => !ID.test(id)))
+        throw Error('brain.context.id-invalid');
+    if (pedido.length > LIMITE)
+        throw Error('brain.context.too-many');
+    const fonte = new Map((0, company_brain_source_1.portfolioEntities)((0, portfolio_1.readPortfolio)(c.raiz), { tenant, instance: c.manifesto.project.name, thread, aclRef: 'ork-factory' }).map(e => [e.id, e]));
+    const base = { schema: exports.CONTEXT_SCHEMA, tenant, contrato: company_brain_contract_1.CONTRACT_HASH, thread, pedido };
+    // O pai só entra por um filho visível e tem kind acima dele: init, proj e prod fecham em três voltas.
+    const pai = (id, parent) => typeof parent === 'string' && ID.test(parent) && ORDEM[kindDe(parent)] < ORDEM[kindDe(id)] ? parent : null;
+    const doServidor = resolverPeloServidor(transport, tenant, pedido, fonte, pai);
+    const caminho = doServidor === null ? 'consulta' : 'servidor';
+    const encerrar = (r) => ({ ...base, state: r.state, ...(r.error ? { error: r.error } : {}), itens: [], lacunas: [],
+        digest: null, consultadoEm: new Date().toISOString(), caminho });
+    if (doServidor && 'state' in doServidor)
+        return encerrar(doServidor);
+    const resolvido = doServidor ?? resolverPelaConsulta(transport, tenant, pedido, fonte, pai);
+    if ('state' in resolvido)
+        return encerrar(resolvido);
+    const { escopo, brain, retidos, semCitacao } = resolvido;
     const itens = [], lacunas = [];
     const lacuna = (id, codigo) => lacunas.push({ id, codigo });
     for (const id of escopo) {
@@ -95,12 +224,19 @@ function buildContext(c, ids, transport, thread) {
             lacuna(id, 'brain.retido');
             continue;
         }
+        // Sem citação no Brain vale como no caminho da consulta: o Brain tem a entidade, mas ela não é citável.
+        if (semCitacao.has(id)) {
+            lacuna(id, 'citacao.incompleta');
+            continue;
+        }
         const b = brain.get(id), f = fonte.get(id);
         if (!b && !f) {
             lacuna(id, 'entidade.desconhecida');
             continue;
         }
-        const entidade = b ?? f, citacao = citacaoDe(entidade.source);
+        // Suspeitas da revisao de 03/10: a citacao exige `authority` nos dois caminhos, como o servidor (o
+        // schema do Source a exige); sem isso, um Brain fora do contrato dava pacote e digest diferentes por caminho.
+        const entidade = b ?? f, citacao = citadoPeloServidor(entidade.source) ? citacaoDe(entidade.source) : null;
         if (!citacao) {
             lacuna(id, 'citacao.incompleta');
             continue;
@@ -128,5 +264,5 @@ function buildContext(c, ids, transport, thread) {
     lacunas.sort((a, b) => comparar(a.id, b.id) || comparar(a.codigo, b.codigo));
     // O digest cobre o que foi dito e de onde veio; o horário da consulta fica fora para o pacote ser reproduzível.
     const corpo = { ...base, state: (itens.length ? 'ok' : 'empty'), itens, lacunas };
-    return { ...corpo, digest: (0, company_brain_contract_1.digest)(corpo), consultadoEm: new Date().toISOString() };
+    return { ...corpo, digest: (0, company_brain_contract_1.digest)(corpo), consultadoEm: new Date().toISOString(), caminho };
 }

package/dist/company-brain-journal.js

@@ -118,7 +118,8 @@ function withProcessLock(dir, busy, run) {
 }
 function durableAppend(file, value) {
     fs.mkdirSync(path.dirname(file), { recursive: true });
-    const fd = fs.openSync(file, 'a', 0o600);
+    // RM-047: O_NOFOLLOW; um ledger versionado como link não leva o append para fora da raiz.
+    const fd = fs.openSync(file, fs.constants.O_WRONLY | fs.constants.O_APPEND | fs.constants.O_CREAT | fs.constants.O_NOFOLLOW, 0o600);
     try {
         fs.writeFileSync(fd, JSON.stringify(value) + '\n');
         fs.fsyncSync(fd);

package/dist/company-brain-migration.js

@@ -1,8 +1,42 @@
 "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.brainAdmin = brainAdmin;
 exports.reconcileBrain = reconcileBrain;
 exports.applyBrain = applyBrain;
+const os = __importStar(require("node:os"));
 const node_child_process_1 = require("node:child_process");
 const project_state_1 = require("./project-state");
 const portfolio_1 = require("./portfolio");
@@ -15,7 +49,8 @@ function brainAdmin(c) {
         const dsn = config.database_url_env ? process.env[config.database_url_env] : undefined;
         if (config.mode !== 'orkmind' || !dsn)
             throw Error('brain.configuration.missing');
-        const r = (0, node_child_process_1.spawnSync)(config.cli, ['brain', 'migration'], { cwd: c.raiz, shell: false, encoding: 'utf8', timeout: Math.min(config.timeout_ms, 15000), maxBuffer: 2 * 1024 * 1024,
+        // RM-047: cwd fora do clone; um nome de interpretador em memory.cli não acha arquivo do repositório.
+        const r = (0, node_child_process_1.spawnSync)(config.cli, ['brain', 'migration'], { cwd: os.homedir(), shell: false, encoding: 'utf8', timeout: Math.min(config.timeout_ms, 15000), maxBuffer: 2 * 1024 * 1024,
             input: JSON.stringify({ schema: 'orkmind.company-brain-admin/v1', operation, payload }),
             env: { PATH: process.env.PATH ?? '/usr/bin:/bin', PYTHONDONTWRITEBYTECODE: '1', ORKMIND_DATABASE_URL: dsn, ORKMIND_BRAIN_TENANT: config.tenant } });
         try {